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INTRODUCTION 


This reference manual is intended to explain the utilization of the "SFG-01 
Control Program version 1.0" which resides within the internal 16Kbyte 
ROM of the "SFG-01". 
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1-1 Program Configuration 


The basic configuration of this program (SFG-01 Control Program) 
follows that depicted in Fig. 1.1. 


The M-B10S (Music Bios) controls the hardware of the SFG-01. 

As a tool box, it provides the user various basic I/O modules 
(MBIOS) and utilities required for instrumental sound sysnthesis 
and music processing. 

With the use of MBIOS modules, parameter handling for sound 
synthesis and computer music performance can be carried out 
without any necessity for the user to directly access the hardware 
of the SFG-01. 

Additionally, MBIOS includes several built-in utilities. If used, 
these will provide convenient supplementary services to the user 
that would otherwise have to be programmed by the user. 

These utilities are: 

1) Reocording of performance and playback 

2) Automatic rhythm generation 

3) Loading/saving of voice/automatic performance data 
onto CMT(Cassette Magnetic Tape recorder) 

MBIOS functions can be invoked by issuing SV-Call (Supervisor 
Call) to the system. 

The M-Monitor (Music Monitor) is a demonstration program that 
converts the MSX computer into a synthesizer, and will operate on 
MBIOS. M-Monitor can be invoked from BASIC, by issuing "CALL 
MUSIC". 
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Program Configuration (Fig. 1. 1) 
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1 -2 Design Concept 


The MBIOS was designed with the following main concepts in mind. 

First, MBIOS users should not have to worry directly about the 
hardware. The controls of the built-in FM sound chip, and that of 
midi interface, are all carried out by the MBIOS, freeing the user 
from this task. 

Second, the concept of a virtual instrument should be defined in 
the user's program space. By instrument, we mean the processing 
system for real-time key-on/key-off requests (events). 

MBIOS defines the instrument by using an IDB(Instrument 
Definition Block) that is linked to the built-in FM sound generator 
IC or MIDI interface as the actual instrumental outputs. 

Thus (considering event data being input to the instrument), once 
the instrument is defined, the user can control the FM sound 
generator IC by manipulating only the event data. 

Third, the slot management of the MSX system should be left up 
to user. This enables a multiple number of slots to be used 
together with the M-B10S. In other words, the M-BIOS does not 
address the slots by itself (with some exceptions). This enables the 
user to call out the IRQ processing module of the MBIOS by 
switching the slot to SFG-01 , even when the interrupt is received 
at the user's slot. 

Fourth, there may be parallel prcessing by service calls. 

That is, the processes of Keyboard Scanning and Instrument 
Performance (PLAY), as well as the real-time processes such as 
event buffer handling for automatic reformance, can run 
simultaneously by appropriately issuing MBIOS calls in the user's 
main program or in his interrupt routines. 
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1-3 Hardware Configuration 


The configuration of the hardware is shown in Fig. 1.2. 

The MSX main unit and the SFG-01 are connected together by the 
60-pin cartridge bus. 

50 pins out of the 60-pins form the standard MSX bus, and the 
remaining 10 pins are not in use in the SFG-01. 

Additionally, the right channel of the SFG-01 is equipped with a 
low pass filter with a cut-off frequency around 3 5 KHz. 

The filter is enabled when CSM vocal synthesis is invoked, for CSM 
vocal synthesis is carried out only on the right channel. 
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Hardware Configuration 


(Fig. “1. 2) 
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1-4 Interface With MSX-BAS1C 


This program uses the MSX-BASIC module, HOOK, and MSX main 
unit hardware as shown below. 


1) During M-BIOS CMT access, two HOOK s are used. 

H.KEYI (FD9Ah) 

H.ERRO (FFBlh) 

Also one BIOS call is used. 

J. STMO (00F3h) 

Note that, once a hook is used, MBIOS destroys the previous 
contents of hook entries, and will not restore them, even after 
completion. 

2) The first 16 bytes starting from Address OOOOh of MBIOS is a 
header to enable the MSX-BASIC to jump to the Music-Monitor of 
MBIOS. (The same contents will also appear from Address 4000h 
and up due to the image caused by address decoding scheme of the 
SFG-01). 


OOOOh (ID) 

0002h (INIT) 

0004h (STATEMENT) 
0006h (DEVICE) 
00Q8h 

OOOAh and after 


”AB" 

Address of RETURN instruction 

Address of "CALL MUSIC” 

OOOOh 

OOOOh 

OOOOh 


Interfaces that fall outside the MSX interfacing standards are as 
follows. 

3) During CSM vocal synthesis, IRQ from VDP is reset directly. 
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4) During CMT access, the following BASIC CMT access modules 
are referenced: 

BLOAD (6FD7h), SRCCAS (70B8h), CSRDON (72E9h), 
BPRMIC(700Bh) and CBLODL(702Fh) 

5) During CMT access, the slots are switched by directly accessing 
the BASIC slot registers inside PPI. 

6) VDP and PPI are directly accessed in M-Monitor. 

7) In M-Monitor, the character font table at lBBFh of the 
BASIC ROM is directly referenced. 
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1-5 Versions 


This program contains a 9 byte version code from address 0080h. 


0080h: "MCHFMO" Program ID code 

0086h: 03h ROM serial» 

0087h: OOh FM sound chip type 

0088h: 03h software version # 


For the identification of this program from the application program, 
it is only necessary to look for the first 6 byte code "MCHFMO'' from 
address 0080h. 
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Chapter II Basic Functions 
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2-1 Keyboard, Queue, Musical Instrument, and Event 


The Keyboard, Queue, and Instrument form the fundamental 
structure of M-B10S. 

Fig. 2.1 depicts the relationship of these three main functional 
units. 

The modules on the left side of Fig. 2.1 all deals with keyboard 
related functions. That is, keyboards are input to the music 
processing system. They issue key-on/off requests and associated 
velocity inputs. Since the requests are time dependent, they are 
called events. 

MK, a music keyboard attached to SFG-01 unit, is one of the 
keyboards. 

Any automatic performance process provided by the user could 
also be categorized as a keyboard since it issues events to the 
system as well. 

MBIOS not only supports the "melody" instruments, called general 
instruments, but also supports such “rhythm instruments as 
Chord, Bass, and Percussion instruments. 

Any functional modules acting as inputs to these instruments are 
categorized as keyboards, too. 

In the middle of Fig. 2.1, Queue s are depicted. 

These functional modules act as processing buffers between input 
(events) and the next functional modules, called Instruments. 

Instruments are depicted at the rightmost portion of figure 21. 
These are the function units to play the events coming from the 
Queue, using Instruments that are defined as IDB s. 


( 11 ) 




December 26, 1984 


(Keyboard) 
General Instrument 


(Queue) 


User 


Music Keyboard. 


-1 

Automatic Reproducer. 
_ I 


QU*0-7 


CHORD Instrument 


User 


Automatic Rhythm. 


Generator" 

/fc._ 




P 


..CHORD* 


User 


-1 

CHORD-MK. 

_l 


^ CHORD-KE_ 


^ QU*C 


BASS Instrument 


..CHORD*. 


JL. 


"Automatic Rhythm 
Generator 

PERCUSSION Instrument 


User 


QU*P 


"Automatic Rhythm 
Generator 


(Instrument) 


IDB*0 


IDB*7 


Automatic 

Recorder 


IDB*C 


User 


QU*B 


1DB*B 



7 

> 



IDB*P0 


IDB*P1 


Relationship between Keyboard^QUEUE & Instrument (Fig-2, i) 


( 12 ) 
























































































December 26, 1984 



Instrument Configuration (Fig-2.2) 
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2-1-1 Musical Instrument and Event 


In this manual, ' instrument" is meant to be an event processing 
system. 

There are 8 general instruments" and 4 "special instruments . 

The general instrument is meant to be a normal instrument that 
plays most of the music, accepting keyboard performance events 
(such as melody). 

The special instrument is specifically designed for rhythmic 
performance. It is possible for the MBIOS user to program these 
rhythmic instruments by using general instruments and 
appropriately designing the performance buffer. 

However, MBIOS already provides some useful rhythmic 
instruments for the user who does not want to specifically 
program the rhythm instruments. 

These are: Chord, Bass, Percussion # 0, and Percussion# 1 
instruments. 

The instruments are defined by the control block, called IDB 
(Instrument Definition Block). 

8 general IDB's are referenced as IDB#0, IDB#1,IDB#2,..., IDB#7. 
Chord, Bass, Percussion are referenced as IDB # C, IDB#B, IDB # P0, 
and IDB # P1 respectively. 

Hereafter, depending on the situation, the instrument may be 
refered to as IDB. 

The CSM vocal synthesizer, to be discussed later, is also defined by 
IDB, and is referenced as 1DB#CSM. 


IDB # =0 thru 7 


IDB # 0 to IDB # 7 


8 

9 

10 
11 


IDB # C 

IDB#B 

IDB # P0 

IDB#P1 


Fig. 2.3 IDB numbers 
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2-1 -1 -1 General Instruments 


The general instruments (IDB # 0 - IDB # 7) are the most commonly 
used instruments other than Chord, Bass and Percussion 
instruments. 

They are defined by the allocation of the channel usage of FM 
sound generator IC and MIDI channel, as well as by the preset data 
for the FM sound chip. 

Input to IDB is event data. It is retrieved and processed by the 
P-Call from the single linked Queue to the IDB. 

There are three events: Note-on, Note-off, and All-Note- off. 
Note-on and Note-off are each comprised of 2 bytes of data. 

bit 15 8 7 0 


Note-on 
Note-off 
All-note-off 


1 

KC# 

VELOCITY 


0 

KC # 

0 


(no data) 


KC s (Keycode number) indicates an 8-octave range, with the note 
name being represented by the lower 4 bits, and the octave by the 
upper 3 bits. This KC # format is internal to SFG-01 , and different 
from MIDI keycode representation. 

bit7 3 0 


KC* 


0 


Octave 


Notename 


<0h> C # 

<8h> G 

< 1 h> D 

<9h- G# 

<2h> D* 

<Ah> A 

<3h> - 

<Bh> - 

<4h> E 

<Ch> A # 

<5h> F 

<Dh' B 


(. 


) 


15 
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<6h> F* <Eh> C 

<7h> - <Fh> - 


While the SFG-01 internal KC # looks as shown above, the MIDI KC # 
is a linearly arranged number, with OOh being the lowest note 
and 7fh the highest note. 

Some examples between internal format and that of MIDI are 
depicted here: 


Note 

Internal KC # 

MIDI format KC» 

C#-l 

OOh 

ODh 

A4 

4Ah 

45h 

C3 

7 Eh 

6Ch 


The SFG-01 internal velocity code covers an 8-bit range between 
OOh (Minimum) and FFh (Maximum). 

Observe that this again is different from MIDI velocity format. 
MIDI velocity can be derived from internal velocity format by 
dividing internal code by 2. 

When the events are transmitted from MIDI interface, they are 
attached with additional information to indicate MIDI destination 
channel number, KC # converted to MIDI format, and velocity that 
is converted to MIDI format as well. 

They are as following: 


Note-on 


Note-off 
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All-note-off 


1 

0 

1 

1 

MIDI* 

0 

1 

1 

1 

1110 

0 

0 

0 

0 

0 0 0 0 

1 

0 

1 

1 

MIDI* 

0 

1 

1 

1 

1111 

0 

0 

0 

0 

0 0 0 0 


Where MIDI# is a destination MIDI channel. 

MIDI*=0 - 15 for midi channel * 1 to 16 .respectively. 

MKC* and MVelocity stand for KC* and Velocity in MIDI format, 
respectively. 


In event processing of IDB's, users are advised to note the 
following consideration. MBIOS perforates special processing 
when channels alloted to the IDB are all in use and still there is a 
request to the channel of that IDB. 

That is, the FM sound generator IC has 8 channels (8 notes), out of 
which as many as desired up to the maximum of 8 channels can be 
allocated to IDB. However, when the request for note-on events 
exceed the available channels declared in IDB, the processing will 
differ depending on whether only one channel is being used, or if 
two or more channels are being used. 

When only one channel is being used, and if the second note-on 
request is issued while the first note is still on, then the second 
note-on is granted, stopping the first note and pushing it into the 
stack. 

Then, the note-off of the second key will enable the first key to be 
popped back and keyed on again! two level stacking system). 

When two or more channels are being used, and if the last note-on 
request is made while all 8 channels are used up, the first note will 
simply be keyed off, and the last one will be granted. 

Stacking will not occur (last note priority system). 
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2-1-1-2 Chord Instrument 


The Chord Instrument (IDB"C) is a pre-constructed instrument by 
the fixed allocation of the FM sound generator IC channel (fixed to 
channel 3 and 4) and by the corresponding preset data. 

Events are retrieved fromQU"C and processed by P-CALL. 

Based on the Chord" given by the corresponding event, 3 notes (4 
notes for a 7th) will be generated simultaneously for the Chord 
instrument. 

There are 3 events ( Note-on, NOte-off, and All-note-off) supplied 
with CHORD". 


NOTE ON 
NOTE OFF 
ALL NOTE OFF 


bit 15 8 7 0 



The Chord" is comprised of 4 bits for the name of the root note, 
and 2 more bits to indicate whether the cord is major/minor and 
the existence of the 7th note. 

Actual pitch of the root note is set between KC"=35h(octave 3,F) 
and KC"=44h(octave 4,E). This is equivalent to the range between 
35h and 40h in MIDI key code. 


Chord" 


bit5 4 0 


x 


x 


note name 


<xx> <00>Major 

<01>Minor 
<10>Major 7th 
<ll>Minor 7th 
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Once the root name is specified, associated development for a 
major chord will be, +386, +700, +1016 cents, and +300, +702, 
+ 1002 for a minor chord. 

Additionally, Chord instruments always handle events with 
last-event priority, and single trigger processing. 
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2-1-1-3 Bass Instrument 

The Bass Instrument (IDB#B) is made up by the allocation of the 
FM sound generator IC channel that is fixed to channel 5, and by 
the corresponding set-up data. 

The event will be retrieved from QU # B and processed by the 
P-CALL. 

There are 3 events: Note-on, Note-off and All-note-off. 

These are supplied with a Chord # and a Pointer# for the 
bass-line pitch offset table. 


Note-on 
Note-off 
All-note-off 


bit 15 8 7 0 


1 0 

Chord# 

0 0 0 0 0 

Pointer# 


0 0 0 0 0 0 0 0 

00000000 


(no data) 


The Pointer# is a 3-bit pointer (displacement) to the entry of the 
bass-line pitch offset tables where relative pitch offset to the root 
note is held. 

There are two such tables, one for a major and the other for a 
minor chord. 

When the Pointer# is specified, the contents of the table addressed 
by the Pointer#( pitch offset) are added to the root note indicated 
by the Chord#. Therefore, by issuing Chord#/Pointer# 
information sucsessively with appropriate intervals, it is possible 
to produce the bass notes within the chord frame described in the 
bass-line pitc offset table. 

For a bass instrument, the pitch range of the root note of the 
Chord# 

is set between KC#=25h(octave 2, F) and KC#=34h(octave3,E). 

This is equivalent to the range between 29h and 34h in MIDI key 
code. 

Additionally, this instrument handles events with last-event 
priority, and single trriger mode. 
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2-1-14 Percussion Instrument 


The Percussion Instruments (IDB # P0, IDB*P1) are handled 
together in pairs, and are made up by the allocation of the FM 
sound generator IC, whose channels are fixed to channel 6 for 
IDB # P0, and fixed to channel 7 for IDB # P1, and by the 
corresponding preset data. Events are retrieved from QU # P and 
processed by P-CALL. 


IDB # P0 provides the functions of hi-hat open (HHO), hi-hat close 
(HHC) and hi-tom(HT). 

IDB # P1 provides those of the bass drum (BD), and the low-tom 
(LT). 

The corresponding events are Note-status and All-note-off. 


bit 15 


0 


Note-status 


X 

X 

X 

X 

0 

X 

0 0 


00000000 


bit 15 HHC (trigger) 

bit 14 LT (low tom on) 

bit 13 BD (bass drum on) 

bit 12 HT(high tom on) 

bit 10 HHO (hi-hat open on) 


All-note-off no data 

When Note-status data is issued, it is compared with the previous 
Note- status. 

For the bits that have changed from 0 to 1, the corresponding 
instruments are triggered. 

For the bits that have changed from 1 to 0, the corresponding 
instruments are shut off. 

Also HHC and HHO use the same IDB. The availability of each 
instrument is mutually exclusive, with HHC receiving priority if 
both are requested simultaneously. 


( 21 ) 












December 26, 1984 


2-1-2 Queue 

This section is illustrated in the middle portion of Fig.2.1. 

Queue is a process to handle the queue buffer that is capable of 
accepting up to a maximum of 16 events. 

There are queue's for 8 general events (QU # 0, ... , QU#7) and 3 
specialized events (QU # C,QU # B, QU # P, for Chord, Bass, and 
Percussion respectively). 

Queue's are named as QU # x, and refered as. 

QU # x 

0 thru 7 QU#0 thru QU»7 

8 QU # C 

9 QU # B 

10 QU ff P 


Queue s primary function is to buffer the event flows between the 
keyboard and the process of playing IDB. 

It ensures the asynchronicity of two independent processes 
(keyboard handling and playing IDB's) running simultaneously in 
the program space. Working as a FIFO, this effectively increases 
the data processing rate without having to miss the note or 
seriously delay the performance timing. 

The Queue also merges the event data from a multiple number of 
keyboards, and distributes them to a multiple number of IDB's that 
are linked to a queue. 

The All-note-off event erases presently queued events from the 
queue , and sets the All-note-off flag in the queue. 
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2-1-3 Keyboard 

This section is illustrated in the leftmost portion of Fig. 2.1. 

The keyboard is, in effect, the event generator. 

The external keyboard attached to the SFG-01 (MK) is a music 
keyboard. 

An automatic performance buffer is treated as a music keyboard, 
too. 

For "keyboards", like MK or automatic peformance buffer, events 
are then input to QU#0-QU#7. 

The automatic rhythm generator and the user provided rhythm 
buffers are considered as special keyboards, whose events are 
routed to QU#C, QU#B, and QU#P. 

The attached keyboard (MK) has a Chord-sensitive range, from 
which CHORD-MK is defined. 

CHORD-KB is a special place to hold a once-depressed key code 
within CHORD-MK ( or in user-simulated chord-mk). The purpose 
of holding such a key code is to provide the chord# to the rhythm 
generator (chord and bass), and it holds the chord# even after the 
key-off code is generated. 

Note that certain data is routed to the auto-rhythm or the bass line 
generator. 

There is an SV-call available to change the content of the code 
name held in CHORD-KB. 

It is used to change the chord# in CHORD-KB (providing it to 
rhythm generators such as chord and bass). CHORD-KB is linked 
to QU#C and maintains the key-off state. 

Output of CHORD-MK is ,as explained in section 2-1-1-2, threefold: 
Note-on, Note-off, and All-note-off,which all affect QU#C. 
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2-2 Major parameters by which the FM sound generator 1C creates 
sounds 

The simulation of instruments by the internal FM sound generator 
IC can be set up completely in accordance with the user s requests. 
This section covers topics relating to the setup parameters for 
voicing. To drive the sound generator IC, first of all it is assumed 
that the readers of this manual are already familiar with the 
hardware specification of FM sound generator IC (OPM). 

That is, there are 8 channels available in the FM sound generator 
IC, and only one hardware LFO is provided. 

For details concerning the tone data, refer to the "YRM-102 FM 
Voicing Program Reference Manual". 

Also, the effects and principles of the major voicing/performance 
parameters are covered in this section. 

In order to access the desired parameters, however, it is necessary 
to modify some of the variables in the IDB and MIDB, or to issue 
appropriate S-calls to MBIOS. For details , refer to Chapter IV, 
MBIOS syntax. 


2-2-1 Portamento, Trigger, and Sustain Mode 

The performance mode is further divided into three main modes, 
Portamento mode, Trigger mode, and Sustain mode. 

The first two modes are effective only for general instruments 
with a single tone generator. Sustain mode can is available for all 
general instruments. 

Poratamento is determined by the Speed and the Mode. The 
Portamento Speed determines the rate of pitch shift during the 
portamento, with the Speed=0 being equivalent to no portamento 
effect at ail. 

There are two Portamento Modes, Full Portramento and Fingered 
Portamento. 

In Full Portamento, the Portamento will take effect for any 
Note-on, and in Fingered Portamento, it will take effect only while 
key stacking is taking place. The stacking will take place when 
only one channel is assigned to the instrument, and when the first 
key still being pressed is pushed onto the stack by the second key- 
on, or when the first key is popped out of the stack by the release 
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of the second key. 

Though the portamento is normally modified by IDB variables, 
since MBIOS executes the portamento by using Clock-A of the 
sound generator IC, changing the CLOCK-A interval value in MIDB 
from the initial setting (8000h) will also cause the portamento 
speed to change. 

The trigger type can be determined by using the Trigger Mode. 

By trigger, we mean that the envelope is generated from the very 
beginning at the key-on request. 

A trigger will be generated for every Note-on event during the 
MULTI Trigger mode. However, in the case of a single channeled 
instrument, it is possible not to generate a trigger during key 
stacking, thus continuing the envelope when the second key is on 
, and only changing the pitch accordingly. This is called Single 
Trigger mode. 

Sustain controls the release rate (RR) of the envelope after Note 
-off (mostly to lengthen the release time). 

When Sustain mode is off, the release rate for each operator will 
be computed according to RR of the voice as normal. However, if 
Sustain mode is on, MBIOS will output the Sustain rate (RR) 
contained in IDB to all the operators whose channels are involved 
in Note-off events. 

Thus , it is possible for the user to write his own Sustain handling 
routine under the Sustain mode by simply modifying the contents 
of Sustain rate of thelDB. 

2-2-2 KC Range 

It is possible to set the KC sensitivity range of the IDB, where only 
KC #, s within that range are only accepted. 

Any deviation from this range in the Note-on event will not be 
accepted. However, the Note-off events are not limited in this 
manner. All-note-off events will be accepted and appropriate 
Note-off processing will be carried out. 

This function is useful to implement a register sensitive keyboard, 
such as split keyboard. 
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2-2-3 Transposition 

There are 3 ways to realize transposition; the transposition of the 
entire system, the transposition of an individual IDB, and the 
transposition by means of altering voice data. 

Transposition of the entire system is obtained by modifying the 
Master Transpose variable in MIDB. 

Individual instruments can be transposed via the Instrument 
Transpose variable in the IDB. 

Transposition by voice data is a pitch-shift that has been 
preprogrammed in the voicing data by use of the YRM102 voicing 
program. The primary purpose of this feature is to include the 
"pipe" length of the instrument (8",16",1 3/5 ,etc.) in the voicing 
parameters. 

When transposition via IDB is attempted for the IDB that has been 
enabled by pitchbend, the transposition will not be accessible by 
the user. 

This is because the pitch bend function uses the Instrumant 
Transpose function to accomplish pitch bend. 

Also Pitch Bend Depth by IDB is a single parameter used for the 
entire system so that it affects all the instruments with the same 
amount of pitch bend. 

The Pitch Bend Depth can be programmed from +/- 1 half tone to 
+/- 1 octave with half-tone resolution. 


2-2-4 Volume, Brilliance 

Volume and Brilliance are both OL (Output Level) offsets, with 
Volume being the offset for the carrier, and Brilliance that for the 
modulator. 

Volume is a parameter that exists for every instrument, and can 
be adjusted for every carrier of the instrument. 

However, there is only a single Brilliance parameter within the 
entire system, and this is applied to only the Brilliance-enabled 
modulators. 

The range of both Volume and Brilliance offsets against OL s is 
between 0 dB (MAX) and -48 dB (MIN). 
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2-2-5 LFO 

The operation of the LFO is determined by the Speed, Waveform, 
AMD and PMD commands. 

Speed sets the frequency of the LFO. 

AMD sets the output level of the LFO for amplitude modulation, 
and PMD sets the output level of the LFO for pitch modulation. 

As depicted in the routing of the LFO, in Fig. 2. 4 , LFO outputs 
adjusted by AMD and PMD are common to all the instruments. 

AMS and PMS set the sensitivity to LFO modulation for each 
individual instrument. 

The Triggered Sync function initializes the LFO phase to O(zero) in 
synchronization with Note-on events. 


2-2-6 Noise 

The OPM has a noise generator which is started when operator 3 of 
channel 7 receives a key-on command. 

When a Noise Enable is used for the IDB that uses only channel # 7, 
noise will be generated at the given Noise Frequency. 

Noise Frequency controls the period that quasi-random number 
series repeats by itself. It should be set appropriately so as to 
obtain sufficiently long series of random number generation. 


2-2-7 Velocity 

Velocity refers to the touch intensity at Note-on time (Initial 
Touch), and affects an offset level for the OL of each operator. 

The central value (80h) of the Velocity is used as the normal 
setting. 

When the Velocity increases, the volume gets louder if the carrier 
is sensitive to the velocity, and the sound gets brighter if the 
modulator is sensitive to the velocity. 

The Velocity Depth covers the effective range of the effect caused 
by Velocity. Depth is adjustable for the carriers over a range of 
+-12 dB, and +-6 dB for the modulators. 
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2-2-8 Envelope 

The Envelope can be set independently for each operator. 

As shown in Fig. 2. 5, the shape of the Envelope is determined by 
AR (Attack Rate), DIR (1st Decay Rate), D2R (2nd Decay Rate), RR 
(Release Rate), and by SL (Sustain Level) between the 1st Decay 
and 2nd Decay. 

OL (Output Level) offsets the standard level of envelope. 

The actual OL commanded in the FM sound generator IC is a sum 
total of such offsets as OL (original offset ), OL Adj (adjusted offset 
for algorithm difference). Keyboard Scaling (Keyboard scaled 
offset). Velocity (Velocity offset) and Volume/Brilliance(offset due 
to volume or brilliance control). 

Note that all the offset amounts are in terms of attenuation from a 
0 dB standard. 

The offset range varies depending upon the purpose of usage. For 
example, OL (original offset) can be set over a range of 0 dB to 
-96dB, while OL Adj can be set over a range of 0 dB to -12 dB. 


2-2-9 Keyboard Scaling 

There are two types of keyboard scaling. 

One is for the rate( AR,D1R,D2R,RR) of the envelope. The keyboard 
rate scaling is carried out by hardware internal to the FM sound 
generator IC. 

The higher the KC # , the faster the rates. Depth determines the 
amount of keyboard rate scaling. 

The other type of keyboard scaling is that for level. Unlike 
keyboard rate scaling, this is accomplished by MBIOS. 

KS selects two types of keyboard scaling curves. (See Fig. 2.6). 
When a scaling value corresponding to KC» is taken out of the 
curve, it is multiplied by the Depth to yield the key-scale 
dependent offset (adjusted by Depth in effect). Depth serves as a 
sensitivity adjustment for level scaling. (Up to -24 dB). 


2-2-10 Other Functions 

Multiple (Harmonic number, indicated as an F in the FM voicing 
program) creates integer multiples (1/2,1,2,3,.... 15) of the keyboard 
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pitch for each operator. 

The ratio between the Multiple of the carrier frequency and the 
Multiple of the modulator frequency plays an important role in 
determining harmonic structure of the sound. 

DT2 (Detune # 2/Inharmonic) is used to create inharmonic 
multiples of the keyboard pitch. 

It is useful to create an inharmonic pitch for sound such as a gong, 
bell, etc. 

DTI (Detune* 1 /Fine) is used to shift the pitch of the operator 
slightly out of tune. Detuning is useful to obtain a chorus effect, or 
richer sounds. 

The Feedback Level adjusts the amount of feedback to the first 
operator (from itself) of each channel over a maximum range of up 
to 4 *PI radians. 

This is useful to enrich the upper harmonic structure of the sound 
caused by the 1 st operator. 

Algorithm determines how the operators are connected together. 
There are 8 ways to connect the 4 operators in each channel. 

Stereo L/R is an output-enable function that allows the output to 
be routed to either the left, right, or both channels, as desired. 


( 


29 ) 




December 26, 1984 


! i 

! LFO ■ 

] ! 


channel#!) channel#! 


operator#!) 


operator#! 


operator#2 


operator#3 


Configuration of OPM (Fig. 


c h a n n e 1 # 2 


2. 3) 


( 30 ) 


















December 26, 1984 


Wave form 
LFO speed 


LFO 


AMD A 



PMD 


0 


PMS 


Channel *0 


o 


AMS 


AMS enable 

-o— 


operator *0 


{t 


operator * 1 


£ 


operator 


*2 


fv 


operator * 3 


Channel *1 ____ 
q PMS 

_Q AMS 


Configuration of LFO (Fig. 2.4 ) 


( 31 ) 









































December 26, 1984 


EG value 


Odb - 

\ 

OL 

\D1R 

SL 


/ AR 






! \rr 

i \ 

i \ 

-96db 



i \ 

i \ 

i \ 

---i_V 


Key ON Key OFF 

(trigger ) 


Envelope (Fig. 2. 5) 


Ou tpu t 


LOW 


HIGH 


level 



(Fig 2. G) 


( 32 ) 


K C U 














December 26, 1984 


2-3 MUSIC KEYBOARD 


M-BIOS supports a 49 key keyboard. 

It is as shown in Fig. 2.7. It is used as the mounted keyboard 
(MK), while a portion of it can also be used as the mounted chord 
keyboard (CHORD - MK). 

The MK can be linked with the only general Queue, QU # 0 - QU # 7. 
If this is done, M-BIOS will register all events registered by MK 
into the linked Queue. 

CHORD-MK, if invoked, is linked up with Chord-KB. 


MK only 



Lowest KC* (44 key version) 
2 5h (Internal) 

29h(MIDl) 

Lowest KC* (49 key version) 

1 Eh (Internal) 

24h (MIDI) 


Highest KC* 
5Eh (Internal) 
54h(MIDI) 


MK + CHORD-MK 



(Fig-2.7) 
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2-4 Auto Rhythm Generator 


MBIOS provides a ready-made automatic rhythm generator. 

The processing is carried out via two types of rhythm buffers, 
called RHB (RHythm Buffer). 

One is for auto chord and bass-line-performance. 

Another is for percussion instruments. 

MBIOS ca define up to 16 sets of RHB's (2 RHB's per set, one 
chord/bass RHB and one percussion RHB). 

Of the 16, 6 sets are already used by MBIOS as preset auto rhythm 
patterns. 

The patterns are: 


0 

16 beat 

(8/4) 

1 

slow rock 

(4/4) 

2 

waltz 

(3/4) 

3 

jazz 

(8/4) 

4 

disco 

(4/4) 

3 

swing 

(8/4) 


When a user-programmed RHB is to be used, he has to set the 
pointer to his RHB in the MIDB prior to its usage. 

There are pointer tables for RHB's in the MIDB. MBIOS preset 
patterns are pointed to in the first 6 entries of the tables. 

RHB is a 96 byte buffer in which 96 events can be programmed. 
Each event, or byte, is supposed to last for 1/48 note duration. 
Thus the entire RHB will have the maximum length of 96 times 
1 /48 note duration: that is, 8 quarter notes long. 

In the MIDB, the time signature of the rhythm performance should 
be specified. 

Three kinds of time signatures are available. 

TIME SIGNATURE: 


designation time 

0 4/4 

1 8/4 

2 3/4 
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In the following, the RHB patterns represented in terms of quarter 
notes are depicted for each time signature. 


4/4 

1 

2 

3 

4' 

1 

2 

3 

8/4 

1 

2 

3 

4 

5 

6 

7 

3/4 

1 

2 

3' 

3 

1 

2 

3 


4 

8 " 

3 


When the RHB is played, performance will be repeated from the 
top of the buffer again when the beat marked by * (hatted beat) is 
completed. 

Although the pattern remaining in the RHB after the hatted ( * ) 
beat is not played, it is recommended to fill the RHB with the above 
pattern entirely. This makes possible the switching of time 
signature in the middle of an auto rhythm generation. 

The event format to be filled in the RHB is as following: 

For chord and bass: 


bit 7 0 


* * 

* * 

0 

* * * 


bitO-2 

walking bass table pointer disp. 

bit4-5 

BASS 

<00> 

No operation 



<10> 

Note-off 



<11> 

Note-on 

bit6-7 

CHORD 

<00> 

No operation 



<10> 

Note-off 



<11> 

Note-on 
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For percussion: 


bit7 0 


# 

* 

* 

* 

0 

* 

0 0 


bit2 

HHC trigger 

bit-4 

Low tom 

bit5 

Bass drum 

bit6 

Hi tom 

bit7 

HHO 


When starting the auto rhythm, two options are available. 

The "immediate start” will start the auto rhythm immediately upon 
issuing of the start auto rhythm command. 

When “Sync-start" is specified, MBIOS awaits an event occuring on 
either CHORD-MK or MK, and then the auto rhythm starts. 

To keep auto rhythm running, it is also required to provide a 
clock to MBIOS, via a clock command. 


( 36 


) 











December 26,1984 


2-5 CSM Vocal Synthesis 


The vocal synthesis supported by MBIOS is based upon the 
technique called CSM (Composite Sinusoidal Method). 

It simulates the spectrum characteristics of the human voice by the 
generation of a few sine waves of different frequencies. 

In the case of MBIOS, 4 operators (4 sine waves) approximate 
the spectrum envelope of the voice. 

y(t) = £ Ai * E(t) * sin (w i* t + f;) 

i 

Operator # 1 of channels # 0 through 3 are used to implement the 
above sine waves. 

CSM vocal synthesis data is divided into overall data and frame 
dependent data. "Window" is a time frame (approximately 20 
ms) used to analyze CSM parameters , and it will be used as an 
interval to reconstruct the voice. 

The overall data includes the envelope, E(t). 

The frame dependent data includes the frequency, wi, amplitude, 
Ai, and pitch information of the vocal sound. Pitch can be 
obtained by the interval of resetting the sine wave generation, 
causing the pitch-dependent harmonic components to spread 
around the formant frequency wi. 

When the CSM driver is active, due to heavy IRQ traffic, MBIOS 
suspends all other processes and concentrates on only CSM 
synthesis. 

The CSM driver also requires preset data to be loaded into the FM 
sound generator IC. Hence IDB # CSM is used. The format of 
1DB # CSM is identical to that of any other IDB. However, except 
for voice # 46 in the voice library ( and hence can not be modified 
) there is no user processable data in the IDB # CSM. 
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2-6 Voice Library 


Voice parameters used to simulate an instrumental sound are 
handled together and packed into 64 bytes of data (48 bytes of 
data in the case of the system preset library). 

Its map is shown in section 4-10. 

The voice library holds these voice parameter sets. 

It has a capacity of 48 voices in MBIOS (called SVL, System Voice 
Library), and can be expanded to another 48 voice area in user 
RAM called as UVL (User Voice Library). 

Voices are refered to by number; 0 - 47 for SVL voices, and 64 to 
111 for UVL voices. Voice numbers 48 - 63 are reserved. 

Although it is possible to address all the voices, MBIOS assumes 
the following voices of SVL are special voices dedicated to special 
functions. 

That is; voices 36 - 39 for 1DB # C, voices 40-41 for IDB # B, voice 
44 for IDB # P0, voice 45 for IDB # P1, and voice 46 for IDB # CSM. 

MBIOS is equipped with a CMT (cassette tape) utility to save UVL 
and load it back to UVL. In this case , the file name to transfer is 
permanently fixed to "VOICE". 

The following is a directory of SVL. 
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Content of SVL(System Voice Library) 


0* 

BRASS 1 

164 PICCOLO 

324 

TRAIN 

1* 

BRASS 2 

174 OBOE 

334 

AMBULAN 

24 

TRUMPET 

184 CLARINE 

344 

TWEET 

3* 

STRING1 

194 GLOCKEN 

354 

RAINORP 

4* 

STRING2 

204 VIBRPHN 

36 

RM.BRAS 

54 

EPIAN01 

214 XYLOPHN 

37 

RM.FLUT 

64 

EPIAN02 

224 KOTO 

38 

RM.GUIT 

74 

EPIAN03 

234 ZITAR 

39 

RM.HORN 

84 

GUITAR 

244 CLAV 

404 

Rl.BASS 

94 

EBASS 1 

254 HARPS 1C 

41 

R2.BASS 

104 

EBASS 2 

264 BELL 

42 

SNAREDR 

114 

EORGANl 

274 HARP 

43 

COWBELL 

124 

E0RGAN2 

284 BEL/BRA 

44 

PERC 1 

134 

P0RGAN1 

294 HARMON 1 

45 

PERC 2 

144 

P0RGAN2 

30 STEELDR 

464 

CSM 

154 

FLUTE 

314 TIMPANI 

47 

(Unde f i 


* Enables the loading of 

LFO parameters when used. 
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2-7 Recording and Playback 


MBIOS supports the recording of events retrieved from a queue 
buffer, or playback of the recorded data. 

However, since there is only a single buffer available, it is not 
possible to do both functions at the same time. 

Prior to calling recording or playback function,, the user must 
provide a buffer where bulk of event data is stored or retrieved. 
The name of this buffer is EVB (Event Buffer). There is a service 
call available to tell MBIOS where the EVB is going to be. 

Both recording and playback will be automatically finished when 
the end of the EVB is reached. Recording will also be terminated 
when an ALL-note-off from a corresponding Queue is processed. 

MBIOS also provides CMT transfer of the EVB to save or load with a 
cassette recorder. 
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Chapter III MBIOS Interface 
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3-1 User Interface 


MB10S control is handled via the SV-call (supervisor call) and IRQC 
(lRQ-call). 

On the other hand, MBIOS can call the user via AST (Asynchronous System 
Trap ) and UISV (User Interrupt Service Vector). 

The genral format to transfer data between the MBIOS and the user 
program is by means of registers and tables (or buffers). 

The latter include the MIDB (Master Instrument Definition Block), IDB 
(Instrument Definition Block), EVB ( Event buffer), RHB (Rhythm Buffer) 
and UVL (User Voice Library). 

These are the buffers that are accessible in the program by both MBIOS, 
and the user program. 

There also exist some temporary buffers used in SV-call processing only 
during the specific SV-call routine. 


User 


SV-call, IRQC 

-> 


MBIOS 


AST, UISV 
<- 
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3-2 Memory management 


The management of the cartridge slot is left up to the user. 

For example, assume that 0000h-3FFFh of the BASIC interpreter is 
mapped in front, and when an interrupt needing MB10S service just arrives 
to the system. It is then the user's responsibility to switch the slot so as to 
map the MBIOS slot in front, then get IRQC service by MBIOS, and finally 
switch back to the original slot in order to exit from that interrupt. 

However, as an exception, w r hen loading/saving into the CMT, upon the CMT 
service call request, MBIOS switches the slot ( assuming the primary 
slot # 0 for BASIC only) by itself appropriately to appropriate the CMT 
service provided in the BIOS of BASIC interpreter. 

The memory allocation under MBIOS control is as shown in FIG. 3.1. 

The area from EDOOh to F37Fh is a fixed work space for MBIOS. 

The area from ECOOh to ECFFh is for the MIDB. 

Other areas such as IDB, EVB, RHB, UVL, and the stack area can be allocated 
anywhere between 8000h (or 4000h when CMT routine is not used) and 
ECOOh. 
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Memory arrangement (as seen M - BIOS) (Fig. 

FFFFh 


F380h 


EDOOh 

ECOOh 

COOOh 


8000h 


4000h 


OOOOh 


BASIC WORK 

M- 

-BIOS WORK 

MI DB 




~ 1 

Stack sector 

1 




I D B 
E V B 
R H B 
U V L 


Temporary sector 


S F G - 0 1 
Control Program 


3. 1) 
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3-3 Supervisor Call 


There are 6 different SV-call's available, as follows: 


1-call 

R-call 

K-call 

P-call 

S-call 

M-call 


(Initialize) 

(real time) 

(Music keyboard) 
(Play) 

(Set up) 

(Receive MIDI) 


Of the above, R, K and S require arguments to be transferred. 

Once issued, an SV-call will not return to its call-source until its processing 
has been completed. 

However, it does not mean that SV-call s have to be issued one after 
the other , waiting for the previous one to finish. 

The above 6 call s can be issued simultaneously under certain conditions. 
This feature enables the parallel processing of music events. 

That is, while P and K calls are being processed, R and M calls also can be 
issued. 

To do this, the system was designed that P-calls and K-calls will function 
in either interrupt-enabled or disabled conditions. 

The other SV-calls will run properly, only if interrupts are disabled. 
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I-call (Initialize) 


calling sequence: 

DI 

IM1 

CALL 0090h 
register conditions: 


in out 

f A] 

<C> 

(BCJ 
IDE] 

(HU 

IIX/IY] 

(alternate R.] 

where 

contents do not matter 

arg arguments associated with function code 

* contents will be destroyed 

o contents will be maintained 


tt 

* 

* 

* 

* 

* 

o 


I-call is an initialization requirement for MBIOS. 

It is required to set the interrupt mode to mode-1 prior to making the 
1-call. 

Calling address is at 0090h. 

Also interupts should be disabled before I-call. 


( 46 ) 






December 26, 1984 


R-call (Real time) 


Calling sequence: 

CALL 0093b 


Registers: 



in 

out 

[A] 

func# 

status 

<C> 

- 

error 

[BC] 

arg 

* 

IDE] 

arg 

* 

IHLJ 

arg 

* 

{IX/IYJ 

- 

0 

[alternate R ] 

- 

0 


R-call is a real time processing call. 

To call it, load the A-register with the desired function code. 

Calling entry address is 0093h. 

The functions of R-calls involve generation of events and clocks. Due to 
the real time nature of the processes, they are done very quickly under the 
IRQ-disabled conditions. 

R-call can be issued during K. and P calls. 

Run time error, if detected, will be indicated by the <C> flag. 
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K-Call (Music keyboard) 


Calling sequence: 

DI (or El) 
CALL 


Registers: 


IA1 

<C> 

[BC1 

IDE] 

IHL] 

IIX/IY] 

(alternate 


0096h 


in 

out 

func # 

0 

- 

error 

arg 

» 

arg 

* 

arg 

1 

- 

0 

- 

0 


K-call is used for the initialization of MK and CHORD-MK, and for scanning 
of MK and CHORD-MK. 

The entry address is 0096h. 

For function calls with 01h(scan MK) and 02h(report MK), the interupt can 
be either enabled or disabled. However for the function call 00h(init 
MK), disable the interrupt before K-eall. 

<C> indicates error when set upon completion of the call. 

The busy condition occurs when a K-cail is issued before the previous 
K-call has been completed. The second K-call is ignored. 

This will be indicated by <C>. 
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P-Call (Play) 


Calling sequence: 

DI/EI 

CALL 0099h 

Registers: 


in out 

l A] - 0 

<C> - error 

IBCJ 

IDE] queue map * 

[HLJ 

[IX/IYJ - o 

(alternate R.] - o 


P-call retrieves events from the queue and plays them using the 
corresponding IDB. Calling address is at 0099h. 

It can be issued whether the interrupts are enabled or disabled. 

<C> indicates an error when set upon completion of the call. 

The busy condition occurs when P-call is issued before the previous P-call 
has been completed. The second P-call is ignored. 

This will be indicated by <C>. 
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S-Call (Set up) 


Calling sequence: 
Call 

Registers: 


[A] 

<C> 

1BCJ 

IDE) 

[HL] 

[IX/IY] 

[alternate 


009Ch 


in 

out 

func # 

error # 

- 

error 

arg 

* 

arg 

* 

arg 

* 

- 

0 

- 

0 


S-call is a request that does not require real time processing. 

Calling address is 009Ch. 

The interrupt should be disabled prior to issuing an S-call. 

S-call will be ignored if it is issued when K-call or P-call is busy. If that 
happens, it will be indicated by <C>. 

<0 indicates an error when set upon completion of the call. 

The busy condition occurs when S-call is issued before the previous S-call 
has been completed. The second S-call is ignored. 

This will be indicated by <C> and the A-register will be OOh. 

For S21, S22, S23, S24, and S28-calis, however, the A-register will return 
certain error conditions. When <C> is set, and OOh of A-register is not 
encountered, it means that an error has been detected. For details, see 
Chapter IV. 
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M-call (Receive MIDI) 


Calling sequence: 

DI 

CALL 00A5h 

Registers: 

out 

* 

* 

o 

data/status 
o 
o 
o 


(A] 

<C> 

(BC) 

[DE] 

(HL1 

[IX/IY] 

[alternate R.] - 


M-call scans the MIDI input port. 

If data is present at the port, it fetches the data in the D registe (interface 
status in the E register). 

Entry address is 00A5h. 

Prior to issuing the M-call, disable the interrupt. 

The process will be carried out quickly, and it can be issued even while 
K-call or P-call is busy. 
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3-4 IRQ Processing 


MB10S operates on IRQ mode 1 of the Z80 CPU. IRQ mode 1 should be set 
before an I-call is issued. 

For MBIOS, there are two sources of interrupts that are generated by the 
hardware of SFG-01; i.e., Clock-A and clock-B. 

When I-call is first issued to initialize MBIOS, clock-A and clock-B are 
automatically interrupt enabled. 

For applications that require disabling the clocks, refer to section 3-6. 

Fig. 3.2 dipicts how the interrupts are handled with regard to MBIOS 
processing. 

Depending on which slot, MBIOS slot or the user program slot (such as 
BASIC interpreter), is mapped in front, two situations can be considered 
as an interrupt entry; via SFG-01 or via a user slot. 

When the MBIOS slot (SFG-01) receives the interrupt directly, it jumps to 
the right hand portion of the flow in figure 3.2, (IRQ-call, which is in most 
cases a normal control flow). 

At this point though, there is an option provided to route the control 
entirely to the users own process. This can be accomplished by defining a 
UISV (User Interrupt Service Vector) at location M.I38H of MIDB. 

Throughout the entire control flow of interrupt processing, MBIOS 
provides the branching capability to the users module at several key 
points. This again can be acomplished by pre-defining the user hook 
vectors appropriately in MIDB. 

Now , shown after IRQ-call entry of Fig. 2.3, are further breakdowns of 
interrupt sources. 

Once routed into this portion, the interrupt sources are polled with the 
scanning priority in the order of clock-A, clock-B, and other interrupt 
sources (from VDP and others). 

At this time, the sources of clock-A , and clock-B interrupts are reset, but 
other sources of interrrupts are left un-reset. 

Note that in clock-A handling, portamento processing is first carried out 
before user hooking is made. 

Also the registers are restored before the branch to the user is made, so 
that the user can just issue <EI><RET> when he exits from the interrupt 
routine. 


( 52 ) 




December 26, 1984 


Address 009Fh is an entry designated IRQ-call entry. This is actually the 
true entry point of the interrupt processing. 

If the interrupt is received from a slot other than SFG-01, the user is 
supposed to take care of appropriate slot management to bring up MBIOS 
in front, and issue an IRQ-call. 
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3-5 AST (Asynchronous System Trap) 

AST is a means to transfer the program control from MBIOS to the user 
program asynchronously. 

This is used when MBIOS wants to let the user know the timing of an error, 
or the occurrence of MK or CHORD-MK triggers. The timing of these events 
is, by nature, unknown, thus asynchronous. 

When an AST is required, the user is required to define the trap vectors in 
MIDB prior to the start of real time handling. 

If vectors are not defined, the trapping will not occur. 

There are two trap vectors in MIDB; <M.TRMK> for MK, CHORD-MK and 
<M.TRER> for error. 

Since AST may be generated right in the middle of an SV-call, issuing 
another SV-call or enabling the interrupt is not allowed in the AST 
handler. 

When returning from the AST routine, issue a <RET>. 

Restoring the registers is not necessary. 

Register contents when AST is invoked: 


[A] trap code 

<C> 

[BC] 

[DE] arg 

[HL] 

IIX/IY] 

[alternate R.] - 


( 55 ) 




December 26, 1984 


3-6 Direct Access to MIDB and IDB 


The MIDB (Master Instrument Definition Block) occupies a 256 byte fixed 
area starting at ECOOh. 

The map of MIDB is shown in section 4-8. 

Part of the MIDB is used as a work area by MBIOS. 

MBIOS maintains various system status bytes and the user can refer to 
them to know what is going on (reporting bytes). 

Some bytes are related to the parameters of synthesizer performance, such 
as transposition, clock interval variables, and so on. 

It is possible to directly change these to affect the synthesizer perfomance. 
There are also vectors for USIV (User service Interrupt Vector), and 
AST's. 

When using interrupt and trap functions of MBIOS, it is necessary that 
these vectors be loaded appropiately by the user. 

Finally, some SV-calls require related parameters to be set in MIDB before 
the call is made. 

These calls are related to those for LFO handling, noise, and file name 
specification for the CMT handler. 


The IDB also can be directly accessed to dynamically modify the 
instrument parameters. 

While the MIDB parameters affect entire system performance, the 
parameters in the IDB affect the performance of individual instruments. 
Since the IDB is defined by the user program, its address should be known 
to the user. In section 4-9, the IDB map is depicted. 
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CHAPTER IV MBIOS Syntax 
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4 - 1 I - call 


I Initialize MBIOS 

Registers: 

In 

Out 

IAJ 

* 

<o 

- 

IBC] 

« 

IDE] 

« 

IHLJ 

* 


Initialization includes the following: 

1. Enable clock-A, and clock-B. 

2. Initialize the MIDB. 

3. Gear AST and USIV tables. 

4 . Gear 1DB, UVL, and EVB buffers. 

3. Set RHB*0 through RHB # 5 with default patterns. 

6. Load Bass-line-note-offset tables with default values. 
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Summary of default settings in the MIDB and system status during an 
I-call: 


MIDB: 


Clock-A 

m.clka: 

8000h (enable interrupt) 

dock-B 

n.dkb: 

8000h (enable interrupt) 

Master transposition 

m.trns: 

OOOOh 

LFO speed 

mJfo: 

OOh 

LFO waveform 

m.ctrl: 

Oh (saw-tooth) 

AMD 

m.add: 

OOh 

PMD 

m.pmd: 

OOh 

Noise 

mjiois: 

OOh (disabled) 

UISV table 

m:i38h: 

all OOh 

AST table 

m.trmk: 

all OOh 

RHB (for chord and bass) 

Lrhyl: 

RHB # 0-RHB # 5 filled with 
default values. Rest deared. 

RHB (percussion) 

Bass-line-note-offset table 

tjrhy2: 

RHB # 0-RHB # 5 Med with 
default values. Rest deared. 

for major chord 

Bass-line-note-offset table 

t.rhy3: 

0, +200, +400, +500, +700, 
+900, +1000, +1200 cents 

for minor chord 

t.rhy4: 

0, +200, +300, +500, +700, 
+800, +1000, +1200 cents 

System status: 

Auto-rhythm mode 


mode=00h (refer to R-13 call) 

Default RHB pointed 


RHB # 0 

IDB's 


all deared 

BVB and UVL 


all deared 

Brilliance 


ffh 

Pitchbend 


OOh 
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4-2 R - call 


R - 00 

System AU-note-off 

This issues All-note-off events into all 11 Queues, and 
issues a Note-off event to the Chord-KB. 

Registers: 


IA1 

00h OOh 

<& 

- 

IBCI 

_ * 

[DEI 

* 

IHLI 

* 
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R - 01 AU-note-ofT 


Issues All-note-off event to designated Queue 


Registers 


[A] 

Olh 

OOh 

<o 


<0> 

IBC1 

QU*/- 

x 

(DBJ 

- 

* 

[HU 


» 


QU # IB1 = OOh-OAh 
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R - 02 


Set Event into Queue 


Sets event into designated Queue 


Registers: 


(A} 

02h 

OOh 

<o 

- 

error 

IBC1 

QU*/- 

« 

[DE] 

Event 

* 

IHL] 

- 

* 

QU*(B1 = 

OOh - OAh 



1) An error will be set when the QUEUE is already full, and the 
corresponding event will not be registered into the Queue. 

2) The event format follows that described in Section 2-1-1. 
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R - 04 Set Event into Chord- KB 


Issues event to the Chord-KB. 


Registers: 


[A] 

04h 

OOh 

<o 

- 

error 

IBC1 

-/event 

m 

[DE] 

- 

* 

(HL 


* 


bit7 0 


event IC] 



chord* 


bit0-5 Chord* 
bit6 always 0 
bit7 <0> Chord off 
<1> Chord on 

1) Normally, the event will be registered when CHORD-KB and KB*C are 
linked. 

An error will be set when the Queue is already full. 

2) Except for the condition that Chord-KB is chord-off. This updates the 
Chord* for auto rhythm. 
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R- 05 Set Chord* into CHORD- KB 


Issues the Chord* to the Chord-KB 


Registers: 


(A) 

05h 

OOh 

<o 

- 

error 

(BJ 

-/event 

« 

IDE] 

- 

* 

(HLJ 


S 


eventlC] 


bit7 0 



chord* 


bit0-5 chord* 

bit6 always 0 

bit7 <0> chord off 

<1> chord on 

1) While the Chord-KB is in the Chord-off, this function will change 
the Chord* of the Chord-KB whithout issuing a Chord-on command 
to the Chord-KB. 

2) An error will be set if Queue is full. 
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R - 08 Start Recording 


Start recording from the designated general instrument Queue to the 
BVB. 


Registers: 


[A] 

08h 

OOh 

<C> 

- 

<0> 

IBC] 

qu # /- 

s 

[DE] 

- 

* 

IHLJ 

- 

* 


qu*[B] 


0 0 0 0 


Qu* 


bitO-2 QU* 

bit3-6 always 0 

bit7 always 1 


1) This will be ignored when the EVB is undefined, or during 
recording/playback. 
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R - 09 Set Recording Clock 


This provides the timing clock for recording. 


Registers: 


(A) 

09h 

00h 

<C> 

- 

<0> 

IBCJ 

- 

X 

IDE) 

- 

X 

IHL] 

_ 

X 


1) This will be ignored in any mode but recording. 

2) To formulate the clock pulse train, this is normally issued 
successively (with interrupt clock). 
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R - OA Stop Recording 


This stops the recording from Queue 


Registers: 


IA1 

OAh 

00h 

<C> 

- 

<0> 

IBC] 

- 

* 

(DEI 

- 

* 

IHLI 

- 

a 


1) This registers an All-note-off event for a Queue that was being 
recorded. 

2) This will be ignored in all modes, eicept for recording. 
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R - OB Start Playback 

This carries out playback from the EVB for the designated Queue. 


Registers: 


IA] 

OBh 

OOh 

<o 

- 

<0> 

[BC] 

qu*/- 

* 

IDE] 

- 

* 

(HU 

_ 

X 


bit7 


qu* IB] 


0 0 0 0 


QU* 


bitO-2 QU* 

bit3-6 always 0 

bit7 always 1 

1) This will be ignored when the EVB is undefined, or during 
recording/playback. 
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R - OC Set Playback Clock 

This provides the timing clock for playback. 


Registers: 


[A] 

OCh 

00h 

<o 

- 

<0> 

[BCJ 

- 

* 

(DEI 

- 

* 

[HL] 

- 

* 


1) This will be ignored during every mode except for playback. 

2) To obtain a clock pulse train, this call is normally issued 
successively in the clock interrupt routine. 
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R - OD Stop Playback 


This stops the playback. 


Registers: 


[A] 

ODh 

00h 

<o 

- 

<0> 

IBC] 

- 

* 

IDE] 

- 

* 

[HL] 


* 


1) This sends an All-note-off event for the Queue that was being 
played back. 

2) This will be ignored during all modes, except for playback. 
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R - 10 Start Auto Rhythm 


This starts the automatic rhythm generator. 


Registers: 


IAI 

10h 

OOh 

<C> 

- 

<0> 

IBCI 

-/Mode 

* 

[DEI 

Division/- 

* 

(HU 

_ 

9 


Mode {Cl 


0 0 0 0 0 0 0 


9 


bitO 


<0> Starts immediately. 

< 1 > Starts in synchronization with the Chord 
on trigger of Chord-MK 
(Sync to MR if Chord-MK is not set) 


Division [Dl 


Inserts a divisor number indicating how many R-l 1 calls 
a 1 /48th note are equivalent to. 

<00h> is equivalent to 256. 

1) If a rhythm pattern is already being used, issuing this call will 
start again from the beginning of the RHB. 
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R - 11 Set Auto-Rhythm Clock 

This provides the clock for the automatic rhythm generator. 


Registers: 


1A] 

llh 

Clock* 

<o 

- 

<o 

IBC1 

- 

* 

IDE] 

- 

* 

IHL] 

_ 

m 


Clock* 


This indicates the present reference position of the RHB (in 96 bytes). 
Divided down by 3 when synchronization starts. 

During 8/4 time, the CLOCK* is as shown below. 


FFh 


FFh^ 


Chord-MK 
Chord-on 


OOh—Execute event 0 


Olh 

Olh 


Olh—Execute event 1 
02h 


5Bh—Execute event 94 
5Fh 
5Fh 

5Fh—Execute event 95 
OOh 
OOh 


OOh—Excute event 0 


Olh 

1) This will be ignored during all modes except while playing 
the auto rhythm pattern. 
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R - 12 Stop Auto-Rhythm 


Stops automatic rhythm generator. 


Registers: 


[A] 

12h 

00h 

<0 

- 

<0> 

[BCJ 

- 

* 

IDE] 

- 

* 

IHL] 

_ 

* 


1) Regardless of whether the automatic rhythm generator is on 
or not, this registers AU-note-oTf events to all Queues that have 
been used by the automatic rhythm generator. 
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R - 13 Select Auto-Rhythm Queue 


Selects the queue for auto rhythm 


Registers: 


(A) 

13h 

OOh 

<o 

- 

<0> 

IBCI 

-/Mode 

X 

IDE] 

- 

X 

IHLI 

_ 

X 


ModelCl 


0 0 0 0 


X 


bitO 

<0> Chord-KB and QU # C are linked. 

<1> QU*C and automatic rhythm 
generator are linked, 
bitl QU*B automatic rhythm generator 
bit2 QU # P automatic rhythm generator 
bit3 QU#C automatic rhythm generator 

1) An All-note-off event will be sent to QU # C when bit 0 and bit 3 
have been set. 

Or All-note-off event will be sent to QU # B when bit 1 has been set. 
Or All-note-off event will be sent to QU # P when bit 2 has been set. 
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R- 14 

Select RHB 

Selects RHB for automatic rhythm generator. 

Registers: 


IA] 

Hh OOh 

<o 

<0> 

IBCI 

-/RHB# 

IDE) 

E 

(HU 

E 

RHB*iCl = 

0 to 15 
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R-18 Load LFO 


Load LFO parameters into the FM sound generator IC. 


Registers: 


IAJ 

18h 

00h 

<C> 

- 

<0> 

IBCI 

- 

* 

IDE] 

- 

* 

(HL) 

_ 

* 


Preset the following LFO parameters into the MID6 prior to 
issuing this command. 

MID6 entries: 


M.LFO 

Speed 

M.AMD 

amd 

M.PMD 

pmd 

M.CTRL 

wave form 

M.N01S 

noise 
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R-19 

Load KC 

Loads the KC into the FM sound generator IC 


in out 

[A] 

19h OOh 

<C> 

<0> 

[BC] 

* 

IDE) 

» 

IHL] 

* 


1) It is used to load ICC dynamically during transposition or portamento 

2) Issue this command in synchronization with CLOCK-A, so that 
update timing of the pitch to accomplish poratamento is synchronized 
to clock-A. 

3) This command does not have to be issued when master transpose, 
poratamento, or pitch bend are not being used. 
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R-21 Send data through MIDI 


Outputs a given single byte of data to the MIDI output port. 


Registers: 

in 

out 

(A) 

21h 

OOh 

<o 

- 

error 

IBC1 

-/data 

m 

(DEI 

- 

* 

(HU 

_ 

X 


1) An error will be set if the command is issued while TiRDY is not 
ready. 
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4-3 K-Call 


K-00 I nit MK 


Initializes MK, sets sync-hold for CHORD-MK, sets velocity for MK, 
and establishes the link up between the MK and the specified queue. 


Registers: 



in 

out 

(A1 

OOh 

OOh 

<C> 

- 

busy 

IBCJ 

link/mode 

X 

IDE] 

velocity/- 

X 

IHL1 


X 


link fB] 


0 0 0 0 


Ilf 


bitO-2 QU* (0-7) 

bit7 <0> No link with queue 

<1> Link with queue 


mode IC] 


0 0 0 0 0 0 0 


% 


lsb <0> Use MK only 

<1 > Use Chord-MK and MK 


Velocity (Dl 



bit0-bit7 OOh min. 

ffh max. 
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K-01 

Scan MK 


Scans the MK. 

Event detected will be written into (linked) queue. 

Registers: 


in 

out 

[A] 

Olh 

OOh 

<o 

- 

busy 

IBCJ 

- 

* 

IDE] 

- 

* 

IHL] 

- 

* 


1) The output of this command is to write the detected event into the 
queue. 

2) Normally, to scan the MK, this call needs to be issued successively. 

3) If AST vectors for MIC or Chord-MK has been specified in the MIDfi, 
it will cause AST trapping via AST vectors (see 4-7). 
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K-02 Report MK status 


Scans the MK, and returns the on/off status of the MK. 


Registers: 



in 

out 

[A] 

02h 

OOh 

<0> 

- 

busy 

IBC1 

- 

X 

IDE] 

buffer 

address 

X 

(HLJ 

- 

X 


1) The buffer is comprised of 9 bytes as shown below. 


higher KC* 


lower KC* 


msb lsb 


0 

c 

B 

A* 

0 

A 

G* 

G 









0 

F* 

F 

E 

0 

D* 

D 

C* 

0 

C 

0 

0 

0 

0 

0 

0 
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4-4 P - call 


P Play 


This retrieves events from the designated name, and processes it by 
using the IDB. 


Registers: 



in 

out 

[A] 

- 

OOh 

<C> 

- 

busy 

IBC] 

- 

* 

IDE] 

Queue map 

* 

(HLJ 


X 



QU*0 


QU»7 

QU#C 

QU#B 

QU*P 


1) The retrieval of events from the designated Queue is carried out 
repeatedly until the Queue becomes empty. 
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4-5 S-call 


S-00 

Define IDB 


Either defines or cancels the IDB. 


Registfers: 


in 

out 

[A] 

OOh 

OOh 

<C> 

- 

busy 

IBCI 

IDB*/- 

m 

IDE] 

IDB address 

i 

IHL] 

- 

* 


1) Cancels the IDB when the IDB address (contents of DE) = OOOOh. 

2) Cancelling the IDB, while it is still engaged in key-on, should be 
avoided. 
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Initial setting of the IDB parameters: 


KC range 
Pitchbend depth 
transposition by instrument 
portamento speed 
RR(default sustain value) 
volume 
Voice data 


cleared 


OOh 

OOh 

OOh 

03h 

coh 


OOh to 7eh 


Initial setting of the IDB mode (held in the system): 

sustain-off 

multi-triggered 

fingered portamento (with 0 speed) 
pitchbend enabled (with 0 depth) 

* The above setting is equivalent to issuing, mode=0, via an S-12 call. 
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S - 02 Define EVB 


Either defines or cancels the event buffer (EVB). 


Registers: 



in 

out 

[A] 

02h 

ooh 

<C> 

- 

busy 

IBC1 

size 

* 

[DE] 

address 

B 

[Hi] 

_ 

B 


1) The EVB is calceled when the address in (DEI is OOOOh. 

2) When defined, the contents of the EVB will not be cleared. 
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S - 03 Define UVL 


Either defines or cancels the user voice library (UVL) 


Registers: 



in 

out 

IA] 

03h 

ooh 

<o 

- 

busy 

IBC] 

- 

* 

IDE] 

address 

* 

(HLJ 


S 


1) The UVL is cancelled when the address in IDE] is OOOOh. 

2) When defined, the contents of UVL will not be cleared. 
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S - 04 Initialize EVB 


This initializes the event buffer (EVB). 


Registers: 

in 

out 

lAl 

04h 

ooh 

<o 

- 

busy 

IBC] 

- 

* 

(DEI 

- 

1 

(HL1 

- 

m 
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S - 09 


Assign channel 


This allocates the channels of the FM sound generator IC for the 
requesting IDB. 

Registers: 




in 

out 

IA] 

09h 

ooh 

<o 

- 

busy 

IBC1 

ch # 0 to 3 

* 

IDBI 

ch # 4 to 7 

X 

(HU 

— 

X 


15 8 7 0 


(BCl 

ch*0 ch*l 

ch # 2 

ch # 3 




IDB # corresponding to 
ch#3 

IDE) 

ch # 4 ch # 5 

ch«6 

di # 7 

1) The function assigns IDB* between 0 and Ah using 4-bit slot for 


each channel number. 

2) IDB*C, IDB # B, IDB # P0, and IDB#P1 use the following fixed 
channels: 


ch»3,4 for IDB#C, ch#5 for IDB # B, ch#6 for IDB#P0, and ch#7 for 
IDB # P1. For IDB # P0 and IDB#P1, use then at the same time. 

3) For a single channelled IDB, assign a channel to the IDB whose 
number is equivalent to that of channel. (Foe ex., ch # 2 for IDB # 2). 

4) Assigning a channel will not alter the previous settings of the LFO. 
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S-OA 


Assign 1DB to Queue and/or MIDI channel 


This assigns the corresponding input Queue and MIDI output channel 
to the designated general IDB. 

Registers: 

in 

out 

IA] 

OAh 

ooh 

<o 

- 

busy 

IBC] 

IDB#/- 

X 

IDE] 

Queueiink/MIDIlink 

X 

IHLJ 

- 

X 


valid IDB# OOh - 07h 


Queuelink ID] 
MIDIlink IE] 


1 0 0 0 0 

Qu# 


X 

0 0 0 

MIDI# 


bit7 <1> MIDI is assgined 


1) When this call is issued, an All-Note-Off event will be executed 
for the corresponding IDB. 

2) When linking with MIDI, be sure to assign at least one channel of 
the FM sound generator IC to the IDB. 
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S - OB Issue Ail-Note-Off to IDB 


This issues and executes an All-note-off to designated IDB. 

Registers: 

in 

out 

[A] 

OBh 

ooh 

<o 

- 

busy 

IBC1 

IDB*/- 

* 

IDE] 

- 

* 

(HL.1 


* 


Valid UDB* OOhtoOBh 
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S - OC Initialize MIDI 


This initializes the MIDI port 


Registers: 



in 

out 

(A) 

OCh 

ooh 

<C> 

- 

busy 

IBCJ 

- 

Y 

IDE] 

- 

Y 

IHL] 

_ 

Y 


1) When called, this routine disables both the RiRDY and TxRDY 
interrupts of MIDI. 

In other words, MBIOS uses MIDI under a non-interrupted 
condition. 
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S - 10 Set Brilliance 


This sets the system parameter, Brilliance. 


Registers: 



in 

out 

[A] 

lOh 

ooh 

<C> 

- 

busy 

IBCJ 

-/Brilliance 

* 

IDE] 

- 

* 

[HL] 

_ 

X 


Brilliance [C] OOh(dark) - ffh (bright) 

1) Since the Brilliance is a system parameter, this affects the whole 
system, not merely a single instrument. 
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S-U Setpitchbend 


This sets the system parameter, pitchbend. 


Registers: 



in 

out 

CA) 

llh 

ooh 

<o 

- 

busy 

IBC1 

-/Pitchbend 

* 

(DEI 

- 

* 

IHL] 


* 


Pitchbend (Cl 2 s complement representation 
80h -100X 

OOh 0% 

7fh +100% 


1) As in portamento, to realize pitchbend, a R-19 call (updating 
KC) should be repeatedly issued in syncronization to the A-clock 
interrupts. 
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S - 12 Define Play-mode 


This sets the performance mode of the designated 1D6 (by the FM 
sound generator IC). 


Registers: 



in 

out 

(Al 

12h 

ooh 

<o 

- 

busy 

[BCl 

IDB*/Mode 

X 

[DE] 

- 

« 

(HLJ 

_ 

X 


IDB# [B] OOh to 07h 


Mode (Cl 


0 0 0 0 


X 


lsb <1> Sustain-On 
bitl <1> Single triggered 
<0> Multi triggered 
bit2 <1> Full portamento 
<0> Fingered portamento 
bit3 <1> Disable pitchbend 
<0> Enable pitchbend 


( 
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S-13 Set Volume 

This sets the Volume oT the designated IDB. 

Registers: 

in out 

[A] 13h ooh 

<C> - busy 

IBCJ IDB#/VoIume * 

[DB1 

[HU 


IDB# [B] OOhtoOBh 

Volume Id OOh(min) to ffh (max) 
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S-14 Load Voice 

This loads the voicing parameter information of designated IDB 
into the FM sound generator 1C 

Registers: 

in out 

[A] Mh ooh 

<0 - busy 

IBC1 IDB # /- 

1DBJ 
IHL1 


1DB* (B) OOhtoOCh 
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S -15 Get Voice 


This transfers voicing parameter information from the Voice 
library to the voicing parameter area of the designated IDB. 


Registers: 



in 

out 

IA] 

15h 

ooh 

<o 

- 

busy 

IBC1 

IDB # /Voice # 

* 

IDE] 

- 

« 

IHL1 


* 


IDB* IB1 

OOhto OCh 

Voice* IC1 

OOhto 2Fh for SVL 


40h to 6Fh for UVL 


1) The transfer will be ignored if the UVL has not been defined. 
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S - 16 Put Voice 

This transfers the voice parameter information from the IDB to 
the UVL. 

Registers: 

IA] 

<o 

[BC] 

IDE) 

(HLJ 


IDB* (B) OOhtoOCh 

Voice#|C) OOh to 2Fh for SVL 

40h to 6Fh for UVL 

1) The transfer will be ignored if the UVL has not been defined. 


in 

out 

16h 

ooh 

- 

busy 

IDB*/Voice* 

* 

- 

* 


« 
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S - 21 Read UVL 


This reads in the UVL from the CMT. 

Registers: 

in 

out 

(A) 

21h 

error* 

<o 

- 

error 

[BCJ 

- 

« 

IDE] 

- 

* 

[HLJ 

- 

« 

Error* lAl 

00h 

Normal end 


FFh 

Size Error 


(not enough buffer) 
Other non-0* MSX-BASIC error 

1) The file name on the tape is assumed to be "VOICE". 

Search on the tape will be made until "VOICE" is found. 

2) When used, the hook information at H.KEYI and H.ERRO of 
BASIC working area will be destroyed. 

3) If UVL has not been defined, error will be flagged out as 
"size" error. 
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S - 22 Write UVL 


This writes the UVL into the CMT. 

Registers: 

in 

out 

IA1 

22h 

error* 

<C> 

- 

error 

IBCI 

- 

« 

IDE] 

- 

* 

IHLI 

- 

1 

Error* [A] 

00h 

non-0 

Normal end 

MSX-BASIC Error 


1) The file name of the data being written is always assumed to 
be "VOICE". 


2) When used, the hook information at HJtEYI and HJBRRO of 
the BASIC working area will be destroyed. 

3) Prior to issuing the call, the UVL must have been defined. 
Omission of the UVL could cause the system to crash. 
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S-23 Read EVB 


This reads in the EVB from the CMT. 


Registers: 



in 

out 

(A) 

23h 

Error* 

<o 

- 

error 

IBCJ 

- 

s 

(DEI 

- 

* 

IHL] 


X 


Error* [A] OOh Normal End 

FFh Size Error 

Other non-0* MSX-BAS1C Error 

1) Prior to this call, a file name must be placed at M.EFVB of 
MIDB. 

The searching of the filename on the tape will be continuously 
carried out until the file name is found. 

2) When used, the hook information at HJCEYI and HJBRRO of 
the BASIC working area will be destroyed. 

3) If the EVB has not been defined prior to this call, the error will 
be flagged out via size error. 


( 101 ) 







December 27, 1984 


S - 24 Write EVB 


This writes the EVB into the CMT. 

Registers: 

in 

out 

[A] 

24h 

Error* 

<C> 

- 

error 

(BCI 

- 

X 

IDE] 

- 

X 

(HL1 

- 

X 

Error* 

00h 

Non-0* 

Normal End 

MSX-BASIC Error 


1) Prior to this call, a file name must be placed at M.EFVB of 
M1DB. 

2) When used, the hook information at HJCEYI and HBRRO of 
the BASIC working area will be destroyed. 

3) Prior to issuing the call, UVL must have been defined. 
Omission of the UVL could cause the system to crash. 
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S - 28 CSM Voicing 


This will call the CSM vocal synthesis driver. 

Registers: 




in 

out 

[A] 

28h 

Error* 

<o 

- 

error 

IBC1 

- 

* 

IDE] 

CSM buffer address 

X 

[HL] 


X 


Error* 

OOh 

Normal End 


Olh 

Run time er 


1) Prior to calling this command, assign all the channels to the 
IDB*CSM, with voice*46 linked up to it. 

2) In IRQ processing, the control to UISV (user interrupt 
service vector) will not be granted at all during the CSM 
processing. 
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CSM data format 

CSM data is comprised of multiple patterns, which in turn are comprised 
of multiple frames. 


CSM data 


Pattern format 


Frame format 



Frame interval (clock-B) 

7_0 


Pitch (clock-A) 



OL (amplitude) 

7_6_0 

I o| 


KC# (Frequency) 

?_6_4 3_0 

01 octave tone 


OOh - FFh 

-3 -1 

{( 256 -value) *0.286*10 } He 


OOOh - 3FFh i 

{(1024-value) *17.88 *10 & > 1 He 


OOh - ?Fh 

(-0.75*value) db 


( 
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4-6 M - call 


M Receive MIDI 


This scans the input port oT the MIDI interface, and return the data 
if there is a data. 

Registers: 

in 

out 

[A] 

s 

<C> 

X 

IBCI 

o 

[DEI 

data/staus 

(HLl 

0 


Status 1C] 


0 0 

* 

% 

0 0 

* 

0 


bitl 

RxRDY 

bit4 

Overrun Error 

bit5 

Framing Error 
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4-7 AST (Asynchronous System Trap) 


AST-01 MK trigger 


This is an AST caused by the trigger from the MK (Note-on, Note-off) 


Registers: 



out 

IAI 

Olh 

<o 

- 

IBCJ 

- 

(DEI 

Event 

(HU 

_ 


1) . Event [DE] contains the same event data used in Queue. 

2) . To receive this AST control, MK scan (K-01) should be issued 

elsewhere in the program. 

In other words, this AST is invoked during the execution of K-01 
routine, if the vector is defined in the MIDB. 

Users however don't have to worry about the synchronicity of 
both (K-01 call and AST-01 handler) routines. 
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AST-02 Error 

This is an AST caused by the error generated by MBIOS. 

Registers: 

out 

IA] 

02h 

<o 

- 

IBC] 

- 

(DE) 

error*/- 

IHLJ 

- 


Error*lDl 0 0 0 1 Qu* 


0 0 1 0 0 0 0 0 


0 0 1 0 0 0 0 1 


0 0 11 MIDI* 


The Qu # has overflowed. 

EVB is full (end of recording) 
(All-note-off issued) 

EVB end is encountered 
(End of playback) 

MIDI time-out Error 


1) 1 zh error will occur during MK processing or automatic rhythm 
generation. If detected, issue an All-note-off to correspoding 
Queue. 

2) When playback/recording is stopped by usual SV-call, AST 
( 20h and 2lh) will not occur. 

3) 3xh will occur during play processing while MIDI out is specified 
as well. If this occurs, it implies a possible hardware 

error. 
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AST - 03 

Chord-MK Trigger 

This is an AST caused by the Chord-MK trigger (Chord-on. Chord-off) 

Registers: 

out 

IAI 

03h 

<C> 

- 

IBCi 

-/Event 

IDE) 

- 

IHLJ 

- 


Event (C] 


7 k 


Chord* 


bit0-bit5 Chord* 

bit7 <1> Chord-on 
<0> Chord-off 


1). In order to utilize this trap, the same attention used in AST-01 
should be paid. 

That is, issue K-01 call elsewhere in the program. 
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4-8 MIDB 

purpose 

name address to use comments 


m.c l ka $ECOO 

Modify directly clock-a interval 

C + 03 **00 0000 clock-a (low) 

C + 13 **** **** clock-a (high) 

OOOOh - > 18.2 ms (max) 

8000h - > 9.1 ms 

FFCOh - > 0.071 ms (min) 

linear rate 

m.clkb $ EC0 2 

Modify directly clock-b interval 

C + 0 3- - clock-b (low) 

C + 13 **** **** clock-b (high) 

OOOOh - > 72.3 ms (max) 

3000h > 36.4 ms3 

FFOOh -> 0.255 ms (min) 

linear rate 

m.t rn s $EC04 

Modify directly Transpose(Master) 

C+0] **** **** fraction 

C+13 **** **** KC 

2's complement 

m.lfo SEC10 

SV-ca 11 

* * * * **** LFO frequency 

m.amd $EC11 

SV-ca 11 

0*** **** amd 

m. pmd $EC12 

SV-ca 11 

0*** **** pmd 

m.c t r l ScCI3 

SV-call 

0000 00** LFO wave form 

m.nois $ 5 C1 4 

SV-call 


<1>noise Enable 

noise frequency ( 109) 


* 00 -- 

- 00 * 
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f. evb 

$EC1 B 

Status 

recording, playback status 



0000 00*- 
0000 00-* 

<0>playback <1>recording 
<1>on execution 

m. c h r d 

$EC23 

Status 

CH0RD-K3 current status 



*0-- --— 

— o** 

<0>off state <1>on state 
chord# 


m.i38h 

$EC3 0 

Vector 

0038h UISV 






(User Interrupt Service Vector) 

m.ic ka 

$EC32 

Vector 

irq-a UISV 



m.ickb 

$EC34 

Vector 

irq-b UISV 



m. i und 

$EC33 

Vector 

irq-undefined UISV 



m. trirk 

SEC3C 

Vector 

yK,CHDRD-KK trigger 

trap 

address 

m. t r e r 

$EC3E 

Vector 

error trap address 



m.fevo 

$EC44 

SV-call 

CevbT file name <6 

8> 


t. r hyO 

$EC33 

Table 

RH13 time sigunature 

<1 6 

B> 

t. rh y1 

SEC9 3 

Pointer 

RH3(chord,bass) address 

<32 B> 

t.rhy2 

$ E C 3 5 

Pointer 

RHB(purcussion) address 

<32 B> 

t.rhy3 

$EC0S 

Table 

bass-l ine-pitch offset table 




(major) 

<8 3> 

t.r hy4 

SECE0 

Table 

(minor) 

<8 B> 


( 110 ) 





December 27, 198-1 


4-9 

n a m e 


i.krng 


i . p c h b 


i.t rns 


i.port 


i.sus t 


v.name 


IDS 


puroose 

address to use comments 


$00 Modify directly KC range 

[ + 03 0*** * * * * K C # (maximum) 

[ + 13 0*** **** KC# (minimum) 


$02 Modify directly 

0000 **** pitchbend depth 

OOh -> 0 cent 

C1h -> 100 cent 

m m m 

OSh -> 1200 cent 

$03 Modify directly Transpose(I nstrument) 

[+03 **** **** fraction 

£+1 2 ★*** kC 

2 * s complement 

$05 Modify directly 

* * * * * * * * portamento speed 

OOh -> non-portamento 

Olh-> fast 

FFh-> slow 

$06 Modify directly 

0000 **** [RR3 in sustain/on mode 

(same rate for all operators) 


$10 SV-call 


Voice data area 
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-4-10 


08 h 

lOh 


18h 

20 h 

28 h 

30h 

3Fh 


D A T A 


V. NAME 


V. TYPE 

V . L F 0 
V. AMD 
V. PMD 

V. SLOT 
V. CNCT 
V. PMS 
V. NO I S 

V . T R N S 


V. T L 

V . K E L 
V. KS 

V . DTI 
V. AR 

V. DIR 

V . D 2 R 
V. RR 


OPERATOR 

# 1 


OPERATOR 
3 2 


OPERATOR 

#3 


0 0 h 


VOICE 
00 h r 


OPERATOR 

JO 
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v.name $00 
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voice name 


v. type 

$07 

user id-code 

V. If 0 

$08 

LFO frequency 


v. amd 

$09 





— ★ * * 

★ * * ★ 

v. pmd 

$ 0 A 

★ — — — 




-★** 

**** 

v.slot 

$08 

0*-- 

-000 



0-*- 

-000 



0 - - * 

-000 



0--- 

*000 

v.cn ct 

$0C 




— — ★ ★ ★ — — — 


—-—★★★ 


v.pms $00 

0 *** 0 0 — — 


0 - 00 ** 


( 


20h (space) 

30h-39h , 41h-5Ah 

First chr. must be 41h-5Ah 


OOh -> .0008Hz(slow) 

80h -> .2134Hz 

FFh -> 52.9Hz(fast) 

logarithmic rate 


<1>enable load LF0 data 
a md 

7Fh-> deep 


<1>sync LFO in key/trigger 
pmd 

7Fh-> deep 


operator#! enable 
operator#2 enable 
operators enable 
operator#0 enable 


<1>stereo/L output enable 
<1>stereo/R output enable 
feedback level 



7-> 

4 pai 

(deepest) 

a Igor ithm number 


pms 

0-> 

+ /- 0 

cent 


1-> 

+ /- 5 

cent 


2 —> 

+ /- 10 

cent 


3-> 

+ /- 20 

cent 


4-> 

+ /- 50 

cent 


5-> 

+/-100 

cent 


6-> 

+/-400 

cent 


7-> 

+/-700 

cent 

ams 

0 — 

Odb 



1-> 

- 2 4 d 'o 



2-> 

-48db 



3 —-> 

- 9 6 d b 
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v.nois $0E 

*-- enable noise 

-**-- LFO wave form 

00 -> sawtoothed 

01-> rectang ler 

10 ---> triangler 

11 -> sample 5 hold 

-* **** noise frequency 


v.trns $0F 

★★★★ 


Transpose(Voice) 

2's complement 

-12700 cent - 12700 cent 

(100 cent) 


v.tl $00 


0 ★ ★ ★ 


OL(original) 

Odb - 95.25db <0.75db> 


v.vel $01 

*- 000- keyboard level scaling type 

<0> Low pass 
<1> High pass 

-*** 000- velocity depth 

carrier Odb - +/-I0.5db (1.5 db) 
index Odb - +/-5.25db (0.75db) 

- 000* enable brilliance 


v.ks $02 

****- 


— — — — 


keyboard level scaling depth 
Odb - -22.5db (1.5db) 
TL(adjust) 

Odb - -11.25db (0.75db) 


v.dtl $03 


— — — — — 




— — — — 


— — — — ★ ★ ★ ★ 


DTI 

sign of DTI 

0 -> positive(up) 

1 -> negative(down) 

data of DTI 

3-> max 

multiple 

0-> *0.5 

1 -> *1 

2 -> *2 

15 ---> *15 
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v.ar 


v. dl r 


v. d2r 


v.rr 


$04 

** 0 - -- 

—o* **** 


keyboard rate scaling 

the higher KC#, the faster rate 
AR 31 -> fast 


$05 


*00- 

<0> 

<1> 

disable ams (= modulator) 
enable ams (= carrier) 

-00* **** 

DIR 

31 —-> fast 


$06 


***- — — — — 

DT2 

0-> 0 

1 -> *1.41 

2 -> *1.57 

3 —-> *1.73 

-* 

D2R 

15-> fast 

*★**- 

SL 

turning point to 2nd decay 



0-> Odb 

1 ---> - 3db 



13 -> -39db 

14 -> -42db 

15 -> -93db 

— — — — 

RR 

1 5-> fast 
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4-11 


U V L 
OOOh r 


007h 


Name 


0 0 h 


012h 
013h 


020h 


0 0 h 


060h 


VO I C E #6 4 


VO I CE#65 


BEOh 


VO I CE#1 1 1 


7 characters 

(alphanumeric characters. 


7 bits identification code 

for user 


space) 
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Setting-up Information 


< fig. 4.1 ) 

o effective 

not effective 


number of channels 
idb#0-7 

item 1 over 1 idb#c idb#b idb#p0/p1 


KC Range 

0 

0 

- 

- 

- 

Pitchbend 

0 

0 

- 

- 

- 

Pitchbend Enable 

o 

0 

- 

- 

- 

Pitchbend Depth 

0 

0 

— 

— 

— 

Portamento Mode 

0 

- 

- 

- 

- 

Portamento Speed 

0 

- 

- 

- 

— 

Trigger Mode 

0 

- 

- 

- 

- 

Sustain Mode 

0 

0 

• 

— 

— 

Volume 

o 

0 

0 

0 

0 

Brilliance 

0 

0 

0 

0 

0 

Brilliance Enable 

o 

0 

0 

0 

0 

T ranspose(Master) 

0 

0 

o 

0 

- 

T ranspose(Instrument) 

o 

0 

o 

0 

- 

Transpose(Voice) 

0 

0 

0 

0 

o 

LFO Speed 

0 

0 

0 

0 

0 

LFO Wave form 

0 

0 

0 

0 

0 

AMD 

0 

0 

0 

0 

0 

PMD 

0 

0 

0 

0 

0 

AMS 

0 

0 

0 

0 

0 

PMS 

0 

0 

0 

0 

0 

AMS Enable 

o 

0 

0 

0 

0 

LFO Trigger Sync 

0 

0 

— 

— 

— 

Noise Enable 

0 

0 

- 

- 

- 

Noise Frequency 

0 

0 

— 

- 

- 

OL(Original) 

0 

0 

0 

0 

0 

OL(Adjust) 

o 

0 

0 

0 

0 

SL 

o 

0 

0 

0 

0 

AR 

0 

0 

0 

0 

0 

DIR 

0 

0 

0 

0 

0 

D2R 

o 

0 

0 

0 

0 

RR 

o 

0 

0 

0 

o 

RR(sustain) 

0 

0 

- 

- 

- 

Operator Enable 

0 

0 

0 

0 

0 

Velocity Depth 

0 

0 

- 

- 

- 

KS(Rate) 

0 

0 

0 

0 

0 

KS(Levei) Type 

0 

0 

- 

- 

- 

KS(Level) Depth 

0 

0 

- 

- 

- 

Multiple 

0 

0 

0 

0 

0 

DTI 

0 

0 

0 

0 

0 

DT2 

0 

0 

0 

o 

0 

Feedback Level 

0 

0 

0 

0 

0 

Algorithm 

0 

0 

0 

0 

0 

Stereo L/R 

0 
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Access Method of Setting-up Information 


item 


KC Range 

Pitc hbend 
Pitchbend Enable 
Pitchbend Depth 

Portamento Mode 
Portamento Speed 
Trigger Mode 
Sustain Mode 

Volume 
Brilliance 
Brilliance Enable 

Transpose(Master) 
Transpose<Instrument) 
Transpose(Voice) 

LFO Speed 

LFO Wave form 

AMD 

PMD 

AMS 

PMS 

AMS Enable 
LFO Trigger Sync 

Noise Enable 
Noise Frequency 

OL(Original) 

OL(Adjust) 

SL 

AR 

DIR 

D2R 

RR 

RR(sustain) 

Operator Enable 
Velocity Depth 
KS(Rate) 

KS(Level) Type 

KS(Level) Depth 

Multiple 

DTI 

DT2 

Feedback Level 
Algorithm 
Stereo L/R 
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( fig. 4.2 ) 


access method 


i.krng (idb) 

S-11 
S-1 2 

i.pchb (idb) 

S-1 2 

i.port (idb) 

S-1 2 
S-1 2 

S-1 3 
S-10 

S-14 (v.vel/voice) 

m.trns (midb) 
i.trns (idb) 


S-14 

(v.trns/voice) 




S-1 8 

(m.1fo 

/midb) , 

S-14 

(v.lfo 

/voice) 

S-1 8 

(m.ctrl/midb) , 

S-14 

(v.nois/voice) 

S-18 

(m.amd 

/midb) , 

S-14 

(v.amd 

/voice) 

S-1 8 

(m.pmd 

/midb) , 

S-14 

(v.pmd 

/voice) 

S-14 

(v.pms 

/voice) 




S-14 

(v.pms 

/voice) 




S-14 

(v.dlr 

/voice) 




S-14 

(v.pmd 

/voice) 




S-18 

(m.nois/midb) , 

S-14 

(v.nois/voice) 

S-18 

(m.nois/midb) , 

S-14 

(v.nois/voice) 

S-14 

(v.tl 

/voice) 




S-14 

(v.ks 

/voice) 




S-14 

(v.rr 

/voice) 




S-14 

(v.ar 

/voice) 




S-14 

(v.dlr 

/voice) 




S-14 

(v.d2r 

/voice) 




S-14 

(v.rr 

/voice) 





i.sust (idb) 

S-14 (v.slot/voice) 
S-14 (v.vel /voice) 
S-14 (v.ar /voice) 
S-14 (v.vel /voice) 
S-14 (v.ks /voice) 
S-14 (v.dtl /voice) 
S-14 (v.dtl /voice) 
S-14 (v.d2r /voice) 
S-14 (v.cnct/voice) 
S-14 (v.cnct/voice) 
S-14 (v.cnct/voice) 
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CHAPTER V Writing programs 
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5-1 Program example 


The following sample program will demonstrate the following instruments. 

manual performance by MIC with IDB*0 

auto play of IDB # 1 

auto rhythm of IDB'PO and IDB«P1 

Program explanations will be made in the following sections. 

With the example program, it is assumed that the VDP and the PP1 of the 
MSX system have already been initialized by MSX-BASIG 
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5.1.1 Program structure 

Lines between 35 and 50 show the framework of the sample program. 
Here, the IRQ mode is set to mode-1. Stack area is defined, and SFG-0,1 is 
set to slot 3. 

As well as initializing the system, UISV and AST vectors are defined in the 
MIDB. 

Note the clock-B vector, defined in line 46, routes the control to interrupt 
processing entry (lines 195 and 196); then real time rhythm handler 
’ auto:" (lines 22-4 to 24-4) is invoked. 

The idea of the program is to use clock-B for the auto-rhythm clock, 
handle the events there, and play them in the main loop of the program. 


5.1.2 Definition of instruments 

In the sample program, IDB # P0, IDB # P1, IDB # 0 and 1DB # 1 are defined in 
the line numbers between 59 and 129. 

Between lines HI and 1-4-4, the channels of the FM sound generator IC are 
assigned to the above IDB’s. 

Assignment details are; 

IDB # 0 channels 0,2,3,*4,5 

IDB # 1 channel 1 

IDB # P0 channel 6 

IDB*P1 channel 7 


5.1.3 Performance of IDB # 1 

IDB # 1 is supposed to play the performance data that is defined in the lines 
between 246 and 262. 

With the auto-rhythm clock synchronized to IBB#P0/1, the event data is 
loaded into queue (QU* 1). This is done in the lines between 225 and 244. 
This routine "auto:” is of course driven by the interrupt, and the event 
requests in the queue are then played by the main loop between line 165 
and 178. The playing is carried out by the lines from 166 and 168. 
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5.1 *4 Manual play by MK 


MK is initialized in the lines between 136 and 139. Here, CHORD-MK is not 
used. Velocity is set to a default value of 80h. MK is linked up with 
QU*0. 

With this setting, the lines 169 to 170 in the main loop issue the MK 
scanning request. If key actuation is detected, the events are sent into 
QU*0, which will be played by a P-call between lines 166 and 168. 

In this example, since the MK scan is placed in the main loop, no MK 
trapping is used. The method of detecting MK events via MK trap (by 
defining AST vector in MIDB) would also be possible. 


5.1.5 Auto-rhythm performance 


Between lines 146 and 148, the queue for auto rhythm is selected. Here 
only QU»P is chosen. 

Then between lines 149 and 151, the RHB (rhythm buffer) to be used is 
selected. This determines the rhythm pattern. Here, preset pattern #0 is 
chosen. 

Qock handling for the rhythm is done in clock-B handler "auto” between 
lines 225 and 244. 

Here, with lines 225 and 226, an auto-rhythm clock is issued in 
synchronization to the clock-B interrupt. 

Actual start of the auto rhythm is specified in the lines between 152 and 
155- In this case, the rhythm is will begin with the first note-on from 
MK. 

Note that, as explained before, the IDB#1 performance is supposed to be 
synchronized to the auto ryhthm. Therefore in ’auto: ' routine, line 227 
checks if the rhythm has already started or not (before it loads the event 
intoQU*!). 
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MAIN 


z30.i3080 ass.vr-1.2 9-SEP-84 19:52 


PAGE 1 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
1 2 
1 3 

14 

15 

16 
17 
13 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 


8000 


/////////////////////.//////////////////////////////////, 

/ 

idb#0 mk (5 channels) / 

idb#1 auto-play (6 channels) / 

idb#p0/p1 auto percussion / 

/ 

//////////////////////////////////////////////////////// 


0099 

io.vdp 

= 

$99 

/ 

vdp sta tus regis ter 

0 0 A 8 

io.ppa 

- 

$A 8 

/ 

primary slot register 

0090 

/ 

i ca11 

= 

$0090 

t 

I-call entry 

0093 

rca 11 

= 

$0093 

i 

R-call entry 

0096 

k c a 11 

= 

$0096 

t 

K-call entry 

0099 

p c a 11 

= 

$0099 

t 

P-call entry 

009C 

s c a 11 

- 

$009C 

/ 

S-call entry 

D000 

/ 

stack 

= 

$0000 

/ 

stack a rea 

EC32 

s 

m . i c k a 

z 

$EC 32 

/ 

hoo k (i rq-a) 

EC 3 4 

m . i c k b 

- 

$E C 34 

/ 

hoo k (irq-b) 

EC38 

m.iund 

- 

$EC38 

/ 

hook (irq-undefined) 

EC3E 

ni.trer 

f 

.=$3000 

$E C3E 

f 

hook (trap-error) 

00 

flag: 

.byte 

$0 

/ 

queue/full flag 


/✓✓///////////////////////✓///////////////////////////// 
/ Initial Setup Procedure / 

//////////////////////////////////////////////////////// 


35 

8001 

F 3 




d i 


36 

8002 

ED 

56 



i ml 


37 

3004 

3^1 

00 

DO 


Id 

sp,stack 

38 





/ 


39 

8007 

3E 

03 



Id 

3,303 

40 

8009 

D 3 

A8 



out 

io.ppa 

41 





/ 


42 

8006 

CD 

90 

00 


call 

i c a 11 

43 

300E 

21 

1 0 

31 


Id 

h l , i rqa 

44 

8011 

22 

32 

EC 


Id 

(m.ic ka),hl 

45 

8014 

21 

IB 

81 


Id 

hl,irqb 

46 

801 7 

22 

34 

EC 


Id 

(m.ickb),hl 

47 

301 A 

21 

35 

81 


Id 

hl,irqv 

48 

8010 

22 

38 

EC 


Id 

(m.iund),hl 

49 

3020 

21 

BF 

81 


Id 

h l,t r ap 

50 

8023 

22 

3E 

EC 


Id 

(m.trer),hl 

51 





/ 




disable IRQ 
IRQ-mode is <mode-1> 
define stack area 

select SFG-01 slot 
SFG-01=slot#3(primary) 


I-call 

define 


'HOOK' 


define ' TRAP 1 


52 
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53 





;////////////////////////////////////////////////////✓/// 

5 4 





;/ 

IDS 

Setup Procedure 

/ 

55 





;//////////////////////////////////////////////////////// 

56 





/ 




57 





/ 

III 

idb#bp0 III 


56 





/ 




59 

8026 

3E 

00 



Id 

a,$00 

; define i db#p0 

60 

3028 

06 

OA 



Id 

b,$0A 


61 

80 2 A 

11 

00 

EB 


Id 

d e,$E BO 0 

; 

62 

8020 

CO 

9C 

00 


call 

scall 

; 

63 

8030 

3d 

15 



Id 

a,$15 

; get voice 

64 

8032 

01 

2C 

OA 


Id 

bc,$0A2C 

/ 

65 

3035 

CO 

9C 

00 


call 

scall 

/ 

66 

8038 

3E 

14 



Id 

a, $1 4 

; load voice 

67 

80 3 A 

06 

OA 



Id 

b,$0A 

0 

66 

803C 

CD 

9C 

00 


call 

scall 

/ 

69 

803F 

3E 

1 3 



Id 

a,$13 

; set volume-balance 

70 

8041 

01 

FF 

OA 


Id 

bc , $0AFF 

; 

71 

8044 

CD 

9C 

00 


call 

scall 


72 





/ 




7 3 





i 

III 

idb#p1 III 


74 





/ 




75 

8047 

3E 

00 



Id 

a,$00 

; define idb#p1 

76 

8049 

06 

OB 



Id 

b,$0B 

; 

77 

304 B 

1 1 

80 

EB 


Id 

de,$EB80 

; 

73 

304E 

CD 

9C 

00 


call 

scall 


79 

8051 

3E 

15 



Id 

3,$15 

; get voice 

80 

8053 

01 

20 

OB 


Id 

bc,$0B2D 

/ 

81 

8056 

CD 

9C 

00 


call 

scall 

/ 

82 

3059 

3E 

14 



Id 

a,$14 

; load voice 

83 

805B 

06 

OB 



Id 

b, $08 


84 

8050 

CD 

9C 

00 


call 

scall 

; 

85 

8060 

3E 

1 3 



Id 

a,$13 

; set volume-balance 

86 

8062 

01 

FF 

08 


Id 

bc,$0BFF 


87 

8065 

CD 

9C 

00 


call 

scall 


88 





r 




89 
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MAIN 

z30. 

i803 

90 



91 



92 



93 

8068 

3E 

94 

806 A 

06 

95 

806C 

1 1 

96 

306r 

CD 

97 

8072 

31 

98 

6074 

06 

99 

3076 

11 

100 

8079 

CO 

101 

807C 

3E 

102 

307E 

01 

103 

8031 

CO 

104 

8084 

3E 

105 

8036 

06 

106 

3088 

CO 

107 

808B 

3E 

106 

3080 

01 

109 

8090 

CO 

110 



111 



112 



113 

8093 

3E 

114 

8095 

06 

115 

8097 

11 

116 

80 9 A 

CD 

117 

3090 

3E 

116 

809F 

06 

119 

80A1 

11 

120 

30A4 

CD 

121 

30A7 

3E 

122 

30 A v 

01 

12 > 

30 AC 

CD 

124 

30 AF 

3E 

125 

3081 

06 

1 26 

3 0B 3 

CD 

127 

80B6 

3E 

128 

80B8 

01 

129 

3088 

CD 

1 30 



1 31 




ass.vr-1.2 9-S6P- 


00 

01 

SO EA 
9C 00 
OA 
01 

00 81 
9C 00 
1 5 

09 01 

9C 00 
14 
01 

9C 00 
13 

CO 01 
9C 00 


00 

00 

00 EA 
9C 00 
OA 
00 

00 80 
9C 00 
15 

00 00 
9C 00 
14 
00 

9C 00 
13 

FF 00 
9C 00 


19: 

52 PAGE 

III 

idb#1 III 

Id 

a, $00 

Id 

b,$01 

Id 

de,$EA80 

call 

s c a 11 

Id 

a , $0A 

Id 

b, $01 

Id 

de,$3100 

call 

sc a 11 

Id 

a,$15 

Id 

be,$0109 

call 

s c a l l 

Id 

a,$14 

Id 

b, $01 

call 

s c a l l 

Id 

a,$13 

Id 

be,$01 CO 

call 

s c a l l 

III 

idb#0 III 

Id 

a,$00 

Id 

b, $00 

Id 

de,$E AO 0 

call 

s c a 11 

Id 

a , $0A 

Id 

b, $00 

Id 

dt,$8000 

Cf.ll 

scalt 

Id 

a,$15 

Id 

be,$0000 

call 

s ca 11 

Id 

a,$14 

Id 

b, $00 

call 

s c a l l 

Id 

a,$13 

Id 

be,$00FF 

call 

sea 11 

.page 



; define idb#1 
/ 

/ 

/ 

; assign idb#1 to qu#1 
/ 
t 
/ 

; get voice 
/ 

/ 

; load voice 

/ 

t 

; set volume-balance 
/ 

/ 

; define i db #0 
/ 

$ 

r 

; assign idb*0 to qu#0 

/ 

/ 

; get voice 
§ 

/ 

; load voice 
/ 

/ 

; set volume-balance 


< 
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132 





/////// 




133 





;/ 

Other 

Se tup 

/ 

134 





;//////////////////////////////////////////////////////// 

135 





/ 




136 

30BE 

3E 

00 



Id 

a,$00 

; define MK 

13 7 

80 CO 

01 

00 

80 


Id 

be,$8000 

; link MK to qu^O 

13tt 

30C3 

1 1 

00 

80 


Id 

de,$8000 

; velocity =3Oh 

139 

80C6 

CD 

96 

00 


call 

kcall 


140 





/ 




141 

80C9 

3E 

09 



Id 

a , $09 

; assign channels 

142 

30CB 

01 

00 

01 


Id 

be,$0100 

; 

143 

30 CE 

1 1 

Ad 

00 


Id 

de,$00A8 


144 

30D1 

CO 

9C 

00 


call 

scall 


145 





/ 




146 

80D4 

3 E 

13 



Id 

a , $1 3 

; select auto-rhythm queue 

147 

8006 

OE 

04 



Id 

c , $04 


148 

80 D'8 

CO 

93 

00 


call 

r c a 11 


149 

3008 

3E 

14 



Id 

a , $1 4 

; select RHB 

150 

30DD 

OE 

00 



Id 

c , $00 


151 

30DF 

CD 

93 

00 


call 

r c a 11 

; 

152 

30E2 

3 E 

10 



Id 

a,$10 

; start auto-rhythm 

153 

80E4 

OE 

01 



Id 

c , $01 


154 

80E 6 

16 

01 



Id 

d, $01 


155 

80E 3 

CO 

93 

00 


call 

r c a 11 


156 





/ 




157 

30L8 

3E 

00 



Id 

a,$00 

; clear queue/full flag 

156 

80ED 

32 

00 

80 


Id 

(f l ag ) , a 

? 

159 





/ 




160 





/ 




161 





;//////////////////////////////////////////////////////// 

162 





;/ 

Main 

Loop 

/ 

163 





;//////////////////////////////////////////////////////// 

164 





/ 




165 

80F0 

F 8 



10$: 

e i 


; Enable IRQ 

166 

30F1 

3E 

00 



Id 

a,$00 

; P-c a11 

167 

30F3 

11 

03 

04 


Id 

de,$0403 


168 

30F6 

CD 

Q9 

OO 


call 

pea 11 


169 

80F9 

3E 

01 



Id 

a,$01 

; MK-scan 

170 

60FU 

CD 

96 

00 


call 

kcall 

; 

171 

80 Ft 

3 A 

00 

80 


Id 

a,(flag ) 

; check queue/full flag 

172 

3101 

A 7 




a nd 

a 


173 

3102 

28 

EC 



j rz 

10$ 


174 

31 04 

31 

00 



Id 

a , $00 

; reset queue/full flag 

175 

31 06 

32 

00 

80 


Id 

(flag),a 

; 

176 

3109 

3E 

00 



Id 

a,$00 

; all note off (system) 

177 

3103 

CD 

93 

00 


call 

r c a 11 


178 

310c 

18 

EO 



j r 

10$ 

/ 


1^0 .page 
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PAGE 


181 

182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 

193 

194 

195 

196 

197 
1 98 

199 

200 
201 
202 

203 

204 

205 

206 
207 
203 

209 

210 
211 
212 

213 

214 

215 

216 
217 
213 

219 

220 
221 
222 
223 


8110 
3113 
311 5 
3118 


81 1 3 
31 1 E 
8121 
8123 

3125 

3126 
81 27 
81 28 
8129 
31 2 A 

8123 
S12C 
31 2D 
312E 
81 2F 
31 31 

3133 

3134 


CD 
3 E 
CD 
C 3 


CD 
CD 
FD 
DD 
D1 
Cl 
FI 
El 
FB 
C 9 

E 3 
F 5 
C 5 
D5 
DD 
FD 
E 5 
C 9 


8135 
81 36 

8138 

8139 FB 
313A C9 


F 5 
D8 

FI 


;/ 


2B 

19 

93 

21 


2B 

3B 

El 

El 


81 

00 

31 


81 

31 


//////////////////////////////////////////////////////// 


IRQ Procedure 


;//////////////////////////////////////////////////////// 
III irq-a III 


i rqa: 


call 

Id 

call 
j mp 


regs av 
a,$19 
r c a 11 
regge t 


III irq-b III 


i rqb: 


E5 

E5 


call 
call 

regget: pop 
pop 
pop 
pop 
pop 
pop 
e i 
ret 

/ 

regsav: ex 

push 

push 

push 

push 

push 

push 

ret 


regsav 
auto 
i y 

i x 
de 
b c 
af 
hi 


(sp),hl 
a f 
b c 
de 
i x 

i y 
hi 


III irq-vdp III 


99 


i rqv: 


push 
i n 
pop 
e i 
ret 

- page 


a f 

io.vdp 
af 


save register 
load opm KC 

restore register 


save regis ter 
auto-rhythm & playback 
restore register 


save register 


save register 
reset vdp-irq 
restore register 
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247 
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253 
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255 
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81 38 
81 3D 

3E 

CD 

1 1 

93 

00 


f 

auto: 

Id 

call 

; set auto-rhythm clock 
r c a 11 ; 

3140 

8142 

FE 

C8 

FF 




cpi 

ret 

; already started ? 

z ; 

3143 

8145 

16 

5F 

00 




Id 

Id 

d /$00 ; get event for idb#1 

e, a ; 

3146 

21 

5F 

81 



Id 

hi,100$ 

8149 

19 





add 

hl,de ; 

81 4 A 

7 E 





Id 

a , (h l) ; 

81 4 B 
314D 

E 6 
C8 

FF 




and 

ret 

$ FF ; eventexist? 

Z ; 

314E 

3150 

8151 

3153 

06 

57 

IE 

3E 

01 

80 

02 




Id 

Id 

Id 

Id 

b/$01 ; set event into qu#1 

d / a ; on/off, kc# 

; velocity 

a,$02 

3155 

CD 

93 

00 



call 

rcall 

3158 
8159 
81 5B 
815E 

DO 

3E 

32 

C 9 

FF 

00 

30 



ret 

Id 

Id 

ret 

nc ; queued full ? 

a ' 5FF ; set queue/full ftag 

(flag),a ; 

/ 

815F 

BE 

00 

00 

00 

100$: 

-byte 

$BE,$00,$00,$00,$00,$00 

8165 

00 

00 

3 E 

CS 


-byte 

$00,$00,$3E,$C8,$00,$00 

316d 

00 

00 

00 

00 


-byte 

$00,100,$00,$00,$00,$48 

81 71 

BE 

00 

00 

00 


-byte 

$BE,$00,$00,$00,$00,$3E 

31 77 

BE 

00 

00 

00 


-byte 

$BE,$00,$00,$00,$00,$00 

31 7D 

00 

00 

3E 

C 8 


-byte 

$00,$00,.$3E,$CS,$00,$00 

3183 

00 

00 

00 

00 


-byte 

$00,$00,$00,$00,$00,$43 

8189 

BE 

00 

00 

00 


-byte 

$9E,$00,$00,SOO,$00,$3E 

81 8F 

BE 

00 

00 

00 

/ 

-byte 

$BE,$00,$00,$00,$00,$00 

31 95 

00 

00 

3 E 

C3 


-byte 

$00,$00,$3E,$C8,$00,$00 

81 9B 

00 

00 

00 

00 


-byte 

$00,$00,$00,$00,$00,$48 

31 A1 

BE 

00 

00 

00 


-byte 

$BE,$00,$00,$00,$00,$3£ 

31 A 7 

BE 

00 

00 

00 


-byte 

$BE,$00,$00,$00,$00,$00 

31 AD 

00 

00 

3E 

C3 


-byte 

500,$00,$3E,$C3,$00,$00 

31 B3 

00 

00 

00 

00 


-byte 

$00,$00,$00,$00,$00,$43 

81 B9 

BE 

00 

00 

00 

/ 

-byte 

$BE,$00,$00,$00,$00,$3E 






? 

/ 

III trap (error) III 

31BF 
31 CO 

7 A 

E6 

FO 



/ 

trap: 

Id 

ani 

3/d ; check queue/full ? 

$F0 

81 C 2 

FE 

10 




cpi 

$1 0 

31 C4 

CO 





ret 

n Z ; 

31C5 

31 Cd 

32 

C9 

00 

30 



Id 

ret 

(flag),a ; set queue/full flag 


. end 
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5.2 Supplementary explanation for recording and playback 


The following outlines the procedures necessary to carry out recording and 
playback. 

-Define necessary IDB's and associated queues. 

-Define EVB via S-02 call 
-Initialize EVB via S-04 call 


-Use R-Oc call for time clock for playback 
-Use R-09 call for time clock of recording 

-Clock can be free running, regardless of whether recording or playback is 
is actually taking place. 

-Start recording via R-08 call 
-find recording via R-Oa call 

-Recording will also end when All-note-off is issued into queue, or when 
EVB gets filled (Trap by <M.TRER> of the MIDB will also occure if so 
defined). 

-Start playback via R-OB call 
-End playback via R-OD call 

-Playback will also end when the end of data in the EVB is encountered 
(Trap by <M.TRER> of MIDB will also occure if so defined) 
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5-3 Supplementary explanation for Auto-rhythm 

The following procedures are necessary to carry out the auto-rhythm 
performance. 


-Define necessary IDBs. 

-Define RHB (rhythm buffer) by writing the pointers to RHB in <TJtHYl> 
(for chord/bass) and <T.RHY2> (for permission) of MIDB. 

These are 32 byte tables for each, serving 16 entry pointers each. 
OOOOh means that corrsponding RHB is not defined. 

-Specify time signature by writing it into <T.RHY0> of MIDB. 

There are 16 entries for 16 RHB's. 

-Use an R-l 1 call for auto rhythm clock. 

-The rhythm clock can be free running. 

-An R-l 1 call will return the current pointer in the RHB, so that it may be 
used to synchronize the particular accent of the rhythm to another 
processes. 

-Use the R-13 call to specify which queues (QU#C, QU#B, QU#P) are to be 
used. 

-Use the R-04 or R-05 call to send event to the CHORD-KB. 

-The CHORD-KB will provide note information to the chord generator and 
the walking bass-line generator, as well as providing events to QU # C 
-Use the R -14 call to select the RHB. 

-Start auto rhythm via an R-l0 call. 

_Stop the rhythm via an R-12 call. 
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5-4 Supplementary information for the CMT usage 


-Use the S-03 call to define the UVL. 

-Use the S-21 call to load the UVL into memory (from the CMT). 

-Use S-22 call to save the UVL to the CMT 

-For the UVL load/save, the file name is fixed to ’ VOICE". 

-Use the S-23 call to load the EVB into memory. 

-Use the S-24 call to save the EVB to the CMT. 

-The file name for the EVB can be specified via <M.FEVB> of the MIDB. 
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5-5 Monitor usage 

Even though M-monitor can be invoked via BASIC's "CALL MUSIC, it can 
also be called by an assembler program. 

Once called by the user program, depressing the <ESO key will return the 
control to the user again. 

Calling sequence: 

D1 

CALL 00A2h 
Some points worth noting are: 

-M-monitor will use a user supplied stack. 

-In calling M-Monitor, the foiowing IDB's must have been assigned at the 


shown address. 


IDB # 0 

E900h 

IDB # 1 

E980h 

IDB # C 

EAOOh 

IDB # B 

EA80h 

IDB#P0 

EBOOh 

IDB # P1 

EB80h 


-Define the UVL so that M-monitor can use it. 

-Define the EVB so that M-monitor can use it, and this case, be sure to 
initialize it (use S-04 call). 

For 16k RAM system, reserve at least 4k bytes for the EVB. 

For 32k RAM system, reserve at least 8k bytes for the EVB. 
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5-6 Problems and solutions 

1. LFO synchronization 

To ensure that the LFO functions properly, immediately before the 
P-call, move msb of VPMD (internal offset in IDB is 1 Ah) to msb of 
Y.SYNC (internal offset in IDB is OAh). 

It is recommended to carry out this procedure each time the P-call is 
issued. 

2. Disabling noise 

When shifting from the noise-enabled state to the noise disabled state, 
set noise-disable on <M.NOIS> of MIDB and issue an R-18. 

3- Disabling clock-A and clock-B. 

-Make sure that address 0087h is OOh. 

-Write 15h into address 3FF0h. 

-Write OOh into address 3FFlh. 

Note that clock-A and dock-B will be enabled again by an I-call. 

4. Statement call from BASIC 

When ~extension call" is made to MBIOS from MSX-BASIC, MBI05 
does not retain the original contents of the HL registers. 

Because of this, the Muisc Macro program will not run if the cartridge 
is inserted in the slot after the SFG-01. The Music Macro program 
should always be placed in a lower alot than the SFG-01. 

5. Output level after I-call 

Even after an I-call has been issued, sometimes the output level may 
not necessarily decrease, thereby causing sound to still be heard. 

To make sure of complete silence, following an I-call, assign every 
channel to the IDB, and issue an All-note-off (S-OB call) to the IDB. 

6. Only a single event will be processed at a time for P-calls corresponding 
to QU#C, QU*B, and QU*P. 
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7. During the playback processing, the very last event in the EVB will not 
be processed. 


8. Velocity 

If velocity is OOh or odd number (its lsb is on), normal operation may 

not be possible during MIDI output 

It is recommended to avoid these values for velocity. 


9. The problem of IRQ flag 

When R, K, P and S - calls are made under IRQ-enabled mode, the 
interrupt status might be reset to the disabled mode when the service is 
completed. 

After the call, if so desired, it is a good practice to set IRQ enable again. 

10. Changing the KC (Key code) range 

Prior to changing the KC range, make sure to issue All-Note-Off 
command to the designated IDB. 
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